使用 Snowsight 暂存文件

使用 Snowsight 时,无需编写 SQL 代码即可创建和管理命名暂存区。还可以将文件上传到命名内部暂存区,以便查看文件、引用 Python 工作表中的文件或 将数据从文件加载到表

不能使用 Snowsight 将文件上传到用户暂存区或表暂存区。有关暂存区的更多信息,请参阅 数据加载概述

本主题内容:

创建暂存区

您可以使用 Snowsight 创建命名内部或外部暂存区。

备注

To create a stage, you must use a role that is granted or inherits the necessary privileges. For more information, see 访问控制要求 for CREATE STAGE.

创建命名内部暂存区

要使用 Snowsight 创建命名的内部暂存区,请执行以下操作:

  1. 登录 Snowsight。

  2. 在导航菜单中,选择 Create » Stage » Snowflake Managed

  3. Create Stage 对话框中,输入 Stage Name

  4. 选择要在其中创建暂存区的数据库和架构。

  5. (可选)取消选择 Directory table。目录表允许您在暂存区中查看文件,但需要仓库,因此会产生费用。您可以选择暂时取消选择此选项,稍后再启用目录表。

  6. 选择暂存区中所有文件支持的 Encryption 类型。有关详细信息,请参阅 内部暂存区的加密。创建暂存区后,无法更改加密类型。

    备注

    要启用数据访问,请使用服务器端加密。否则,暂存文件默认为客户端加密,下载后不可读。有关更多信息,请参阅 用于非结构化数据访问的服务器端加密

  7. 填写描述暂存区的字段。有关更多信息,请参阅 CREATE STAGE

  8. 选择 Create

创建命名外部暂存区

要使用 Snowsight 创建指定外部暂存区,请执行以下操作:

  1. 登录 Snowsight。

  2. 在导航菜单中,选择 Create » Stage » External Stage

  3. 选择外部云存储提供商:Amazon S3Microsoft AzureGoogle Cloud Platform

  4. Create Stage 对话框中,输入 Stage Name

  5. 选择要在其中创建暂存区的数据库和架构。

  6. 输入外部云存储位置的 URL

  7. 如果外部存储不是公开的,请启用 Authentication 并输入详细信息。有关更多信息,请参阅 CREATE STAGE

  8. (可选)取消选择 Directory table。目录表允许您在暂存区中查看文件,但需要仓库,因此会产生费用。您可以选择暂时取消选择此选项,稍后再启用目录表。

    If you enable Directory table, optionally select Enable auto-refresh, and then select your event notification or notification integration to automatically refresh the directory table when files are added or removed. For more information, see 自动目录表元数据刷新.

  9. If your files are encrypted, enable Encryption, and then enter your details.

  10. (Optional) To view a generated SQL statement, expand the SQL Preview. To specify additional options for your stage, such as AUTO_REFRESH, you can open this SQL preview in a worksheet.

  11. 选择 Create

将文件上传到暂存区

可使用 Snowsight 将文件上传到命名内部暂存区。

要将文件上传到外部暂存区,请使用您的外部云服务(Amazon S3、Microsoft Azure 或 Google Cloud Storage)提供的工具。

将文件上传到命名内部暂存区

备注

文件大小上限为 250 MB。

要将文件上传到内部暂存区,必须使用被授予或继承对数据库和架构的 USAGE 权限以及对暂存区的 WRITE 权限的角色。有关更多信息,请参阅 暂存区权限

要将文件上传到暂存区,请执行以下操作:

  1. 登录 Snowsight。

  2. 选择 Data » Add Data

  3. Add Data 页面上,选择 Load files into a Stage

  4. 在显示的 Upload Your Files 对话框中,选择要上传的文件。一次可以上传多个文件。

  5. 选择在其中创建暂存区的数据库架构,然后选择暂存区。

  6. (可选)在暂存区中选择或创建保存文件的路径。

  7. 选择 Upload

将文件上传到暂存区之后,可以根据具体文件执行以下操作之一:

查看暂存文件

可以使用 Snowsight 查看暂存文件。可查看内部和外部暂存区中的文件。

备注

必须使用被授予或继承对数据库和架构的 USAGE 权限以及对暂存区的 READ 权限的角色,才能执行这些步骤。

  1. 登录 Snowsight。

  2. 选择 Data » Databases

  3. 选择包含暂存区的数据库和架构。

  4. 选择 Stages 并选择要查看其文件的暂存区。

  5. 如果显示提示,请选择 Enable Directory Table,为暂存区启用目录表,这样才能查看文件。

  6. 如果显示提示,请选择一个仓库以刷新目录表。

若要刷新暂存区中的目录表,请选择刷新图标。

管理暂存文件

可以使用 Snowsight 对暂存文件执行以下操作:

对于内部暂存区中的文件,还可以执行以下操作:

  • 选择 更多选项 » Download,可从暂存区下载文件。

  • 选择 更多选项 » Remove,可从暂存区中移除文件。

备注

要从外部暂存区下载文件,请参阅 在 Snowsight 中下载暂存文件

管理暂存区

要在 Snowsight 中管理暂存区,请执行以下操作:

备注

必须使用被授予或继承对数据库和架构的 USAGE 权限以及对暂存区的 OWNERSHIP 权限的角色,才能执行这些步骤。

  1. 登录 Snowsight。

  2. 选择 Data » Databases

  3. 选择包含暂存区的数据库和架构。

  4. 选择 Stages,然后选择暂存区。

  5. 选择 Stage Details

可以通过以下方式管理暂存区:

  • 选择 更多选项 » Edit,为暂存区对象编辑属性或启用目录表。

  • 选择 更多选项 » Clone,克隆暂存区。

  • 选择 更多选项 » Drop,删除或移除暂存区。

  • 选择 更多选项 » Transfer Ownership,将暂存区的 OWNERSHIP 权限转移给其他角色。

如果要管理暂存区的权限,请使用 Privileges 部分查看、授予和撤消权限。

故障排除

外部暂存区中的文件不可见

当外部暂存区未启用目录表,或者有关外部存储位置的信息不正确时,就可能会出现此问题。

要解决此问题,请尝试以下操作:

  • 确保暂存区所有者已在暂存区上启用 目录表

  • 检查目录表是否已刷新。若要刷新目录表,请在 Snowsight 中选择暂存区,然后选择刷新图标。

  • 验证云提供商 URL 是否正确。如果 URL 包含子路径,请确保末尾带有一个斜杠。

Upload Files 按钮不可用(未激活)

如果您不具备将文件上传到内部暂存区所需的权限,或者系统正在进行其他上传时,就可能会出现此问题。

要解决此问题,请尝试以下操作:

  • 确保已选择内部暂存区。

  • 使用被授予或继承对数据库和架构的 USAGE 权限以及对暂存区的 WRITE 权限的角色。

  • 检查是否正在进行其他上传。将鼠标悬停在未激活的按钮上,即可显示有关任何正在进行的上传的信息。Snowsight 也会显示有关正在进行的上传的通知。如果正在进行其他上传,则必须先完成上传,然后才能将其他文件上传到暂存区。

语言: 中文