使用 Snowsight 暂存文件¶
使用 Snowsight 时,无需编写 SQL 代码即可创建和管理指定暂存区。还可以将文件上传到指定内部暂存区,以便查看文件、引用 Python 工作表中的文件或 将数据从文件加载到表。
不能使用 Snowsight 将文件上传到用户暂存区或表暂存区。有关暂存区的更多信息,请参阅 数据加载概述。
本主题内容:
创建暂存区¶
您可以使用 Snowsight 创建指定内部或外部暂存区。
创建指定内部暂存区¶
要使用 Snowsight 创建命名的内部暂存区,请执行以下操作:
登录 Snowsight。
在导航菜单中,选择 Create » Stage » Snowflake Managed。
在 Create Stage 对话框中,输入 Stage Name。
选择要在其中创建暂存区的数据库和架构。
(可选)取消选择 Directory table。目录表允许您在暂存区中查看文件,但需要仓库,因此会产生费用。您可以选择暂时取消选择此选项,稍后再启用目录表。
选择暂存区中所有文件支持的 Encryption 类型。有关详细信息,请参阅 内部暂存区的加密。创建暂存区后,无法更改加密类型。
备注
若要启用数据访问,建议选择服务器端加密。否则,暂存文件默认是客户端加密的,下载时不可读。有关更多信息,请参阅 用于非结构化数据访问的服务器端加密。
填写描述暂存区的字段。有关更多信息,请参阅 CREATE STAGE。
选择 Create。
创建指定外部暂存区¶
要使用 Snowsight 创建指定外部暂存区,请执行以下操作:
登录 Snowsight。
在导航菜单中,选择 Create » Stage » External Stage。
选择文件所在的外部暂存区之一:Amazon S3、Microsoft Azure 或 Google Cloud Platform。
在 Create Stage 对话框中,输入 Stage Name。
选择要在其中创建暂存区的数据库和架构。
输入外部云存储位置的 URL。
如果外部存储不是公开的,请启用 Authentication 并输入详细信息。有关更多信息,请参阅 CREATE STAGE。
(可选)取消选择 Directory table。目录表允许您在暂存区中查看文件,但需要仓库,因此会产生费用。您可以选择暂时取消选择此选项,稍后再启用目录表。
如果启用 Directory table,则可以选择 Enable auto-refresh,并选择事件通知或通知集成,以便在添加或删除文件时自动刷新目录表。要了解更多信息,请参阅 自动目录表元数据刷新。
如果文件已加密,请启用 Encryption 并输入详细信息。
(可选)展开 SQL Preview 以查看生成的 SQL 语句。若要为暂存区指定其他选项,例如 AUTO_REFRESH,可在工作表中打开此 SQL 预览。
选择 Create。
将文件上传到暂存区¶
可使用 Snowsight 将文件上传到指定内部暂存区。
要将文件上传到 Amazon S3、Microsoft Azure 或 Google Cloud Storage 等服务中的外部暂存区,请使用适用于这些云服务的工具。
将文件上传到指定内部暂存区¶
要将文件上传到暂存区,请执行以下操作:
登录 Snowsight。
选择 Data » Add Data。
在 Add Data 页面上,选择 Load files into a Stage。
在显示的 Upload Your Files 对话框中,选择要上传的文件。一次可以上传多个文件。
选择在其中创建暂存区的数据库架构,然后选择暂存区。
(可选)在暂存区中选择或创建保存文件的路径。
选择 Upload。
将文件上传到暂存区之后,可以根据具体文件执行以下操作之一:
使用 Python 工作表中的文件。请参阅 将 Python 文件从暂存区添加到工作表。
将数据从暂存文件复制到表。请参阅 将文件从暂存区加载到现有表中 或 从内部暂存区复制数据。
查询暂存区中的数据。请参阅 查询暂存文件中的数据。
查看暂存文件¶
可以使用 Snowsight 查看暂存文件。可查看内部和外部暂存区中的文件。
备注
必须使用被授予或继承数据库和架构的 USAGE 权限以及暂存区的 READ 权限的角色,才能执行这些步骤。
登录 Snowsight。
选择 Data » Databases。
选择包含暂存区的数据库和架构。
选择 Stages 并选择要查看其文件的暂存区。
如果显示提示,请选择 Enable Directory Table,为暂存区启用目录表,这样才能查看文件。
如果显示提示,请选择一个仓库以刷新目录表。
若要刷新暂存区中的目录表,请选择刷新图标。
管理暂存文件¶
可以使用 Snowsight 对暂存文件执行以下操作:
选择 » Load into table,将暂存区中的文件加载到表。
对于内部暂存区中的文件,还可以执行以下操作:
备注
要从外部暂存区下载文件,请参阅 在 Snowsight 中下载暂存文件。
管理暂存区¶
要在 Snowsight 中管理暂存区,请执行以下操作:
备注
必须使用被授予或继承数据库和架构的 USAGE 权限以及暂存区的 OWNERSHIP 权限的角色,才能执行这些步骤。
登录 Snowsight。
选择 Data » Databases。
选择包含暂存区的数据库和架构。
选择 Stages,然后选择暂存区。
选择 Stage Details。
可以通过以下方式管理暂存区:
如果要管理暂存区的权限,请使用 Privileges 部分查看、授予和撤消权限。
故障排除¶
外部暂存区中的文件不可见¶
当外部暂存区未启用目录表,或者有关外部存储位置的信息不正确时,就可能会出现此问题。
要解决此问题,请尝试以下操作:
确保暂存区所有者已在暂存区上启用 目录表。
仔细检查目录表是否已刷新。若要刷新目录表,请在 Snowsight 中选择暂存区,然后选择刷新图标。
验证云提供商 URL 是否正确。如果 URL 包含子路径,请确保末尾带有一个斜杠。