使用 Snowsight 暂存文件

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

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

本主题内容:

创建暂存区

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

备注

您必须使用被授予或继承对存储暂存区的数据库和架构的 USAGE 权限以及对架构的 CREATE STAGE 权限的角色。

有关 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。目录表允许您在暂存区中查看文件,但需要仓库,因此会产生费用。您可以选择暂时取消选择此选项,稍后再启用目录表。

    如果启用 Directory table,则可以选择 Enable auto-refresh,并选择事件通知或通知集成,以便在添加或删除文件时自动刷新目录表。要了解更多信息,请参阅 自动目录表元数据刷新

  9. 如果文件已加密,请启用 Encryption 并输入详细信息。

  10. (可选)展开 SQL Preview 以查看生成的 SQL 语句。若要为暂存区指定其他选项,例如 AUTO_REFRESH,可在工作表中打开此 SQL 预览。

  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 也能显示有关正在进行的上传的通知。如果正在进行其他上传,则必须先完成上传,然后才能将其他文件上传到暂存区。

语言: 中文