Bulk Loading from Amazon S3 Using COPY

If you already have a Amazon Web Services (AWS) account and use S3 buckets for storing and managing your data files, you can make use of your existing buckets and folder paths for bulk loading into Snowflake.This set of topics describes how to use the COPY command to bulk load from an S3 bucket into tables.

As illustrated in the diagram below, loading data from an S3 bucket is performed in two steps:

Step 1:

Snowflake assumes the data files have already been staged in an S3 bucket. If they haven’t been staged yet, use the upload interfaces/utilities provided by AWS to stage the files.

Step 2:

Use the COPY INTO <table> command to load the contents of the staged file(s) into a Snowflake database table. You can load directly from the bucket, but Snowflake recommends creating an external stage that references the bucket and using the external stage instead.

Regardless of the method you use, this step requires a running, current virtual warehouse for the session. The warehouse provides the compute resources to perform the actual insertion of rows into the table.

Data loading overview

Tip

The instructions in this set of topics assume you have read Preparing to Load Data and have created a named file format, if desired.

Before you begin, you may also want to read Data Loading Considerations for best practices, tips, and other guidance.

Next Topics: