Snowflake - 外部数据加载
Snowflake 也支持客户端的云存储。这意味着客户端可以在他们的云中拥有数据,并且他们可以通过引用位置将数据加载到 Snowflake 中。截至目前,Snowflake 支持 3 个云 - AWS S3、Microsoft Azure 和 Google Cloud Platform Location。这些被称为外部阶段。但是,Snowflake 提供了 snowflake 管理的阶段,这些阶段称为内部阶段。
外部阶段是客户端位置,当用户使用其本地系统目录时,内部阶段会在此位置使用。
要从外部云上传数据,需要进行以下设置 −
Snowflake 中必须加载数据的现有数据库和模式。
指向 AWS S3 存储桶的外部阶段设置。
文件格式,它定义了加载到 AWS S3 中的文件的结构。
在本章中,我们将讨论如何设置这些要求并将数据加载到表中。
我们已经创建了一个名为 TEST_DB 的数据库、模式为 TEST_SCHEMA_1 和表为TEST_TABLE。如果这些不可用,请按照前面章节中的说明创建它们。
可以通过 Snowflake 的用户界面以及使用 SQL 设置外部阶段。
使用 UI
要创建外部阶段,请按照下面显示的说明 −
登录 Snowflake。单击顶部功能区中的 数据库。在数据库视图中,单击数据库名称为 TEST_DB。现在,单击 阶段 选项卡。现在,单击顶部的创建按钮,如以下屏幕截图所示 −
弹出创建阶段对话框,在列表中选择 amazon|s3,然后单击下一步按钮,如下所示 −
将转到下一个屏幕,用户应在其中输入以下详细信息 −
名称 − 这是用户定义的外部阶段名称。将使用相同的名称将数据从阶段复制到表。
架构名称 −选择表所在的架构名称以加载数据。
URL − 提供来自 Amazon 的 S3 URL。它基于存储桶名称和密钥是唯一的。
AWS 密钥 ID − 请输入您的 AWS 密钥 ID
AWS 密钥 − 输入您的密钥以通过 AWS 进行连接
加密主密钥 − 提供加密密钥(如果有)。
提供这些详细信息后,单击完成按钮。以下屏幕截图描述了上述步骤 −
用户可以在视图面板中看到新创建的外部阶段。
使用 SQL
使用 SQL 创建外部阶段非常简单。只需运行以下查询并提供所有详细信息,如名称、AWS 密钥、密码、主密钥,它就会创建阶段。
CREATE STAGE "TEST_DB"."TEST_SCHEMA_1".Ext_S3_stage URL = 's3://***/***** CREDENTIALS = (AWS_KEY_ID = '*********' AWS_SECRET_KEY = '********') ENCRYPTION = (MASTER_KEY = '******');
文件格式定义上传到 S3 的文件的结构。如果文件结构与表结构不匹配,则加载将失败。
使用 UI
要创建文件格式,请按照以下说明操作。
登录 Snowflake。单击顶部功能区中的数据库。在数据库视图中,单击数据库名称为 TEST_DB。现在,单击文件格式选项卡。现在,单击顶部的创建按钮。它将弹出创建文件格式对话框。输入以下详细信息 −
名称 − 文件格式的名称
架构名称 −创建文件格式只能在给定的架构中使用。
格式类型 − 文件格式的名称
列分隔符 − 如果 csv 文件是分隔的,请提供文件分隔符
行分隔符 − 如何识别新行
要跳过的标题行 − 如果提供了标题,则为 1,否则为 0
其他内容可以保留原样。输入详细信息后,单击完成按钮。以下屏幕截图显示了上述详细信息 −
用户将能够在视图面板中看到创建的文件格式。
使用 SQL
使用 SQL 创建文件格式非常简单。只需运行以下查询并提供以下所有详细信息即可。
CREATE FILE FORMAT "TEST_DB"."TEST_SCHEMA_1".ext_csv TYPE = 'CSV' COMPRESSION = 'AUTO' FIELD_DELIMITER = ',' RECORD_DELIMITER = ' ' SKIP_HEADER = 0 FIELD_OPTIONALLY_ENCLOSED_BY = 'NONE' TRIM_SPACE = FALSE ERROR_ON_COLUMN_COUNT_MISMATCH = TRUE ESCAPE = 'NONE' ESCAPE_UNENCLOSED_FIELD = '\134' DATE_FORMAT = 'AUTO' TIMESTAMP_FORMAT = 'AUTO' NULL_IF = ('\N');
从 S3 加载数据
在本章中,我们将讨论如何设置所有必需的参数,如阶段、文件格式、数据库,以从 S3 加载数据。
用户可以运行以下查询来查看给定阶段中存在的所有文件 −
LS @<external_stage_name>
现在,要加载数据,请运行以下查询 −
语法
COPY INTO @<database_name>.<schema_name>.<table_name> FROM @<database_name>.<schema_name>.<ext_stage_name> FILES=('<file_name>') FILE_FORMAT=(FORMAT_NAME=<database_name>.<schema_name>.<file_format_name>);
示例
COPY INTO @test_db.test_schema_1.TEST_USER FROM @test_db.test_schema_1.EXT_STAGE FILES=('data.csv') FILE_FORMAT=(FORMAT_NAME=test_db.test_schema_1.CSV);
运行上述查询后,用户可以通过运行以下简单查询 − 来验证表中的数据
Select count(*) from Test_Table
如果用户想要上传外部阶段中存在的所有文件,则无需传递"FILES=(<file_name>)"