使用 Web 界面加载数据¶

您可以使用 Snowsight 或 Classic Console 加载包含结构化数据（例如 CSV、TSV）或半结构化数据（如 JSON、Avro、ORC、Parquet 或 XML）的文件。

使用 Web 界面从大小不超过 250 MB 的文件中加载数据。要加载更大的文件或加载大量文件，请使用 Snowflake 客户端 SnowSQL。有关更多信息，请参阅从本地文件系统批量加载。

备注

使用账户角色与 Snowsight 进行交互。您可以使用为一个或多个数据库角色授予的账户角色。有关更多信息，请参阅角色类型。

本主题内容：

使用 Snowsight 加载数据¶

可以使用 Snowsight 为以下场景加载文件：

将一个或多个文件从本机加载到现有表中。
将文件从暂存区加载到现有表中。
加载本地文件或暂存文件时创建新表。Snowsight 使用 INFER_SCHEMA 表函数自动检测文件元数据架构，检索列定义，并生成新表。此功能不支持 XML 文件。

您可以从大小不超过 250 MB 的单个文件中加载数据。

备注

要使用 Snowsight 加载数据，则必须使用对要将数据加载到其中的表具有 OWNERSHIP 权限的角色，以及对包含该表的数据库和架构具有 USAGE 权限的角色。请参阅表权限。

如果要使用命名的文件格式，角色还必须具有该特定文件格式的 USAGE 权限。

将文件从本机加载到现有表中¶

登录 Snowsight。
在导航菜单中，选择 Data » Add Data。
在 Add Data 页面上，选择 Load data into a Table。

随即出现 Load Data into Table 对话框。
如果您没有为用户设置默认仓库，请选择一个仓库。
选择 Browse。添加结构化或半结构化数据文件。
选择特定的数据库和架构，然后选择要将数据加载到的表。
选择 Next。
执行下列操作之一：
- 从当前数据库中选择文件格式。
- 选择要自定义的文件类型，然后选择数据文件的相关设置。
（可选）选择在加载过程中发生错误时应采取的措施。默认情况下，不会从文件加载任何数据。
选择 Load。

Snowsight 加载文件并显示成功插入表中的行数。
执行下列操作之一：
- 若要打开具有 SQL 语法的工作表以查询表，请选择 Query Data。
- 要关闭对话框，请选择 Done。
如果无法加载文件，例如，如果文件中的列与表中指定的列不匹配，则会显示一条错误消息。要调整设置，请选择 Back。

将文件从暂存区加载到现有表中¶

将文件从暂存区加载到表中之前，需要创建一个暂存区并将文件上传到该暂存区。有关信息，请参阅使用 Snowsight 暂存文件。

登录 Snowsight。
在对象资源管理器中，选择要从中加载文件的暂存区。
在暂存区的文件列表中，选择要加载到表中的文件。
在所选文件的省略号下拉菜单中，选择 Load into table。
在 Load Data into Table 对话框中，选择要将文件加载到其中的数据库、架构和表。
选择 Next。
执行下列操作之一：
- 从当前数据库中选择文件格式。
- 选择要自定义的文件类型，然后选择数据文件的相关设置。
（可选）选择在加载过程中发生错误时应采取的措施。默认情况下，不会从文件加载任何数据。
选择 Load。

Snowsight 将文件从暂存区加载到表中。

还可以通过复制暂存文件的路径将暂存文件加载到表中。

按照上一过程中的步骤 1-3 操作。
在暂存区所选文件的省略号下拉菜单中，选择 Copy path。
在导航菜单中，选择 Data » Add Data。
在 Add Data 页面上，选择 Load files into a Stage。
在对象资源管理器中，选择要将数据加载到其中的表。
选择 Load Data。
在显示的 Load Data into Table 对话框中，选择 Add from Stage。
将复制的路径粘贴到路径字段中，然后选择 Add。

此时将显示暂存文件名称。
选择 Next。
执行下列操作之一：
- 从当前数据库中选择文件格式。
- 选择要自定义的文件类型，然后选择数据文件的相关设置。
（可选）选择在加载过程中发生错误时应采取的措施。默认情况下，不会从文件加载任何数据。
选择 Load。

Snowsight 加载文件并显示成功插入到表中的行数。

使用 Classic Console 加载数据¶

Classic Console 提供了一个向导，用于将有限数量的数据从一小组文件加载到表中。该向导执行的 PUT 和 COPY 操作与使用 SQL 相同，但将两个阶段（暂存文件和加载数据）合并为一个操作，并在加载完成后删除所有暂存文件。

可以从以下文件中加载数据：本机上的文件，或 Snowflake、Amazon S3、Google Cloud Storage 或 Microsoft Azure 上现有云存储位置中已暂存的文件。

加载数据的先决条件¶

开始使用 Classic Console 加载数据之前，请执行以下操作：

确定数据文件的位置。可以从以下位置之一加载数据：
- 本机。
- 内部或外部暂存区。
- Amazon S3、Google Cloud Storage 或 Microsoft Azure 上的云存储位置，尚未作为外部暂存区添加到 Snowflake。
确定数据文件的大小。您加载的每个文件大小不超过 250 MB。要加载更大的文件或加载大量文件，请改用 Snowflake 客户端 SnowSQL。请参阅从本地文件系统批量加载。

用于加载数据的角色必须具有相应权限：

要加载数据，角色必须具有数据库和架构的 USAGE 权限，数据库和架构包含将数据加载到其中的表。
要在加载数据时创建暂存区，角色必须具有数据库架构的 CREATE STAGE 权限。
要在加载数据时创建文件格式，角色必须具有数据库架构的 CREATE FILE FORMAT 权限。

开始加载数据¶

要开始将文件加载到特定表中，请执行以下操作：

选择 Databases 。
选择特定数据库和架构。
选择 Tables 选项卡。
找到要将数据加载到其中的表。
通过执行下列操作之一，开始将数据加载到特定表中：
- 选择表行，然后选择 Load Data。
- 选择表名称即可打开表详细信息页面，然后选择 Load Table。
Load Data 向导随即打开。
选择用于将数据加载到表中的仓库。下拉列表中包括您在其中拥有 USAGE 权限的所有仓库。
选择 Next。

选择要加载的数据¶

根据您选择从中加载数据的位置，请执行相关步骤。如果要从多个位置加载数据，请多次使用 Load Data 向导。

要从计算机加载数据，请执行以下操作：

选择 Load files from your computer 选项，然后选择 Select Files，即可浏览到要加载的文件。
选择一个或多个本地数据文件，然后选择 Open。
选择 Next。

要从现有暂存区加载数据，请执行以下操作：

选择 Load files from external stage 选项。
从 Stage 下拉列表中选择现有的暂存区。
（可选）指定暂存区中文件的路径。
选择 Next。

要创建暂存区，例如从外部云存储加载数据，请执行以下操作：

选择 Load files from external stage 选项。
选择 Stage 下拉列表旁边的 +。
选择文件所在的受支持的云存储服务。
选择 Next。
填写描述暂存区的字段。有关更多信息，请参阅 CREATE STAGE。
选择 Finish。

系统会自动从 Stage 下拉列表中选择新暂存区。
（可选）指定暂存区中文件的路径。
选择 Next。

完成加载数据¶

选择要加载的文件后，完成将数据加载到表中。

备注

如果在完成加载数据时仓库未运行，则必须等待仓库恢复（不超过 5 分钟）后才能加载数据。

要完成加载数据，请执行以下操作：

从下拉列表中选择现有的命名文件格式，或者创建一个文件格式。

要创建文件格式，请执行以下操作：
1. 选择下拉列表旁边的 +。
2. 填写字段以匹配数据文件的格式。有关选项的说明，请参阅 CREATE FILE FORMAT。
3. 选择 Finish。
系统会自动从下拉列表中选择新的命名文件格式。
确定如何处理加载数据时发生的错误：
- 如果希望在发生错误时停止数据加载，请选择 Load。
- 如果希望以不同的方式处理错误，请执行以下操作：
  1. 选择 Next。
  2. 选择描述如何处理错误的选项。有关选项的详细信息，请参阅 COPY INTO <table> 的“ON_ERROR”章节。
  3. 选择 Load。
Snowflake 使用您选择的仓库将数据加载到您选择的表中。
选择 OK 即可关闭 Load Data 向导。

使用 Web 界面加载数据¶

使用 Snowsight 加载数据¶

将文件从本机加载到现有表中¶

将文件从暂存区加载到现有表中¶

加载文件时创建表¶

使用 Classic Console 加载数据¶

加载数据的先决条件¶

开始加载数据¶

选择要加载的数据¶

完成加载数据¶