本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

將資料從 Amazon Aurora 我的資料SQL庫叢集儲存到 Amazon S3 儲存貯體中的文字檔

您可以使用該SELECT INTO OUTFILE S3陳述式查詢 Amazon Aurora 我的資料SQL庫叢集中的資料，並將其儲存到存放在 Amazon S3 儲存貯體的文字檔案中。在 Aurora My 中SQL，檔案會先存放在本機磁碟上，然後匯出至 S3。匯出完成後，會刪除本機檔案。

您可以使用 Amazon S3 受管金鑰 (SSE-S3) 或 (SSE-KMS: AWS 受管金鑰 或 AWS KMS key 客戶受管金鑰) 加密 Amazon S3 儲存貯體。

LOAD DATA FROM S3陳述式可以使用陳SELECT INTO OUTFILE S3述式建立的檔案，將資料載入 Aurora DB 叢集。如需詳細資訊，請參閱將資料從 Amazon S3 儲存貯體中的文字檔案載入 Amazon Aurora 我的資料SQL庫叢集。

授予 Aurora 我對 Amazon S3 的SQL訪問權限

在將資料儲存到 Amazon S3 儲存貯體之前，您必須先授與 Aurora 我的資料SQL庫叢集存取 Amazon S3 的權限。

授與在我的 Aurora 中儲存資料的權限 SQL

發出 SELECT INTO OUTFILE S3 陳述式的資料庫使用者必須具備特定的角色或權限。在 Aurora 我的SQL版本 3 中，您授予AWS_SELECT_S3_ACCESS角色。在 Aurora 我的SQL版本 2 中，您授予SELECT INTO S3權限。根據預設，會將適當的角色或權限授予資料庫叢集的管理使用者。您可以使用下列其中一個陳述式，將此權限授予另一個使用者。

針對我的SQL版本 3 的 Aurora 使用下列陳述式：

GRANT AWS_SELECT_S3_ACCESS TO 'user'@'domain-or-ip-address'

針對我的SQL版本 2 的 Aurora 使用下列陳述式：

GRANT SELECT INTO S3 ON *.* TO 'user'@'domain-or-ip-address'

此AWS_SELECT_S3_ACCESS角色和SELECT INTO S3權限專屬於 Amazon Aurora MySQL，不適用於我的SQL資料庫或我的RDS資料SQL庫執行個體。如果您已將 Aurora My SQL DB 叢集設定為複寫來源，並將 My SQL 資料庫設定為複寫用戶端之間的複寫，則該角色或權限的GRANT陳述式會導致複寫停止並出現錯誤。您可以放心略過此錯誤並繼續複寫。若要略過 [我的SQL資料庫執行個體] RDS 的錯誤，請使用 mysql _rds_skip_repl_error 程序。若要略過外部我的SQL資料庫上的錯誤，請使用 slave_skip_ error 系統變數 (Aurora 我的SQL版本 2) 或系統變數 (Aurora 我的版本 3)。SQL

指定 Amazon S3 儲存貯體的路徑

指定路徑將資料和資訊清單存放在 Amazon S3 儲存貯體的語法，類似於 LOAD DATA FROM S3 PREFIX 陳述式中使用的語法，如下所示。

s3-region://bucket-name/file-prefix

路徑包含以下值：

由SELECT INTO OUTFILE S3語句創建的數據文件使用以下路徑，其中 00000 代表 5 位數、從零開始的整數。

s3-region://bucket-name/file-prefix.part_00000

例如，假設 SELECT INTO OUTFILE S3 陳述式指定 s3-us-west-2://bucket/prefix 做為路徑來存放資料檔案，並建立三個資料檔案。指定的 Amazon S3 儲存貯體包含下列資料檔案。

建立資訊清單以列出資料檔案

您可以將SELECT INTO OUTFILE S3陳述式與MANIFEST ON選項搭配使用，以列出陳述JSON式建立的文字檔案的格式建立資訊清單檔案。LOAD DATA FROM S3陳述式可以使用資訊清單檔案將資料檔案重新載入 Aurora My SQL DB 叢集。如需使用資訊清單將資料檔案從 Amazon S3 載入 Aurora My SQL DB 叢集的詳細資訊，請參閱使用資訊清單指定要載入的資料檔案。

SELECT INTO OUTFILE S3 陳述式所建立的資訊清單中包含的資料檔案，依陳述式建立它們的順序列出。例如，假設 SELECT INTO OUTFILE S3 陳述式指定 s3-us-west-2://bucket/prefix 做為路徑來存放資料檔案，並建立三個資料檔案和一個資訊清單檔案。指定的 Amazon S3 儲存貯體包含名為 s3-us-west-2://bucket/prefix.manifest 的資訊清單檔案，其中包含下列資訊。

{
  "entries": [
    {
      "url":"s3-us-west-2://bucket/prefix.part_00000"
    },
    {
      "url":"s3-us-west-2://bucket/prefix.part_00001"
    },
    {
      "url":"s3-us-west-2://bucket/prefix.part_00002"
    }
  ]
}

SELECTINTOOUTFILES3

您可以使用 SELECT INTO OUTFILE S3 陳述式從資料庫叢集查詢資料，然後將資料直接儲存至 Amazon S3 儲存貯體中存放的分隔文字檔案。

不支援壓縮檔案。從 Aurora 我的SQL版本 2.09.0 開始，支持加密文件。

語法

SELECT
    [ALL | DISTINCT | DISTINCTROW ]
        [HIGH_PRIORITY]
        [STRAIGHT_JOIN]
        [SQL_SMALL_RESULT] [SQL_BIG_RESULT] [SQL_BUFFER_RESULT]
        [SQL_CACHE | SQL_NO_CACHE] [SQL_CALC_FOUND_ROWS]
    select_expr [, select_expr ...]
    [FROM table_references
        [PARTITION partition_list]
    [WHERE where_condition]
    [GROUP BY {col_name | expr | position}
        [ASC | DESC], ... [WITH ROLLUP]]
    [HAVING where_condition]
    [ORDER BY {col_name | expr | position}
         [ASC | DESC], ...]
    [LIMIT {[offset,] row_count | row_count OFFSET offset}]
INTO OUTFILE S3 's3_uri'
[CHARACTER SET charset_name]
    [export_options]
    [MANIFEST {ON | OFF}]
    [OVERWRITE {ON | OFF}]
    [ENCRYPTION {ON | OFF | SSE_S3 | SSE_KMS ['cmk_id']}]

export_options:
    [FORMAT {CSV|TEXT} [HEADER]]
    [{FIELDS | COLUMNS}
        [TERMINATED BY 'string']
        [[OPTIONALLY] ENCLOSED BY 'char']
        [ESCAPED BY 'char']
    ]
    [LINES
        [STARTING BY 'string']
        [TERMINATED BY 'string']
]

參數

SELECT INTO OUTFILE S3 陳述式會使用下列必要和選用參數，這些參數專供 Aurora 使用。

您可以在我的SQL文件中，在SELECT陳述式和LOADDATA陳述式中找到有關其他參數的詳細資訊。

考量事項

寫入 Amazon S3 儲存貯體的檔案數量取決於SELECT INTO OUTFILE S3陳述式選取的資料量，以及 Aurora My 的檔案大小閾值SQL。預設的檔案大小臨界值為 6 GB。如果陳述式所選取的資料小於檔案大小臨界值，則只會建立單一檔案，否則會建立多個檔案。關於此陳述式所建立的檔案，其他考量包括：

SELECT INTO OUTFILE S3陳述式會傳回一般的 My SQL 錯誤編號，以及成功或失敗時的回應。如果您無法存取我的SQL錯誤編號和回應，判斷何時完成的最簡單方法是在陳述式MANIFEST ON中指定。資訊清單檔案是陳述式寫入的最後一個檔案。換言之，如果您有資訊清單檔案，就表示陳述式已完成。

目前，無法直接監控 SELECT INTO OUTFILE S3 陳述式在執行時的進度。不過，假設您使用此陳述式SQL將大量資料從 Aurora My 寫入 Amazon S3，而且您知道陳述式選取的資料大小。在此情況下，您可以監控 Amazon S3 中建立資料檔案的情形，以估計進度。

在作法上，您知道陳述式選取的資料大約每 6 GB，就會在指定的 Amazon S3 儲存貯體中建立一個資料檔案。將選取的資料大小除以 6 GB，即可估計要建立的資料檔案數目。然後，您可以監控陳述式執行時上傳至 Amazon S3 的檔案數目，以估計陳述式的進度。

範例

下列陳述式會選取employees表格中的所有資料，並將資料儲存到與 Aurora My SQL DB 叢集位於不同區域的 Amazon S3 儲存貯體。在此陳述式所建立的資料檔案中，每個欄位的結尾是逗號 (,) 字元，而每一列的結尾是換行 (\n) 字元。如果符合 sample_employee_data 檔案字首的檔案存在於指定的 Amazon S3 儲存貯體中，此陳述式會傳回錯誤。

SELECT * FROM employees INTO OUTFILE S3 's3-us-west-2://aurora-select-into-s3-pdx/sample_employee_data'
    FIELDS TERMINATED BY ','
    LINES TERMINATED BY '\n';

下列陳述式會選取employees表格中的所有資料，並將資料儲存至與 Aurora My SQL DB 叢集位於相同區域的 Amazon S3 儲存貯體。在此陳述式所建立的資料檔案中，每個欄位的結尾是逗號 (,) 字元，而每一列的結尾是換行 (\n) 字元，此外也建立一個資訊清單檔案。如果符合 sample_employee_data 檔案字首的檔案存在於指定的 Amazon S3 儲存貯體中，此陳述式會傳回錯誤。

SELECT * FROM employees INTO OUTFILE S3 's3://aurora-select-into-s3-pdx/sample_employee_data'
    FIELDS TERMINATED BY ','
    LINES TERMINATED BY '\n'
    MANIFEST ON;

下列陳述式選取 employees 資料表中的所有資料，並將資料儲存至不是位於 Aurora 資料庫叢集所在區域中的 Amazon S3 儲存貯體。在此陳述式所建立的資料檔案中，每個欄位的結尾是逗號 (,) 字元，而每一列的結尾是換行 (\n) 字元。此陳述式會覆寫指定的 Amazon S3 儲存貯體中任何符合 sample_employee_data 檔案字首的現有檔案。

SELECT * FROM employees INTO OUTFILE S3 's3-us-west-2://aurora-select-into-s3-pdx/sample_employee_data'
    FIELDS TERMINATED BY ','
    LINES TERMINATED BY '\n'
    OVERWRITE ON;

下列陳述式會選取employees表格中的所有資料，並將資料儲存至與 Aurora My SQL DB 叢集位於相同區域的 Amazon S3 儲存貯體。在此陳述式所建立的資料檔案中，每個欄位的結尾是逗號 (,) 字元，而每一列的結尾是換行 (\n) 字元，此外也建立一個資訊清單檔案。此陳述式會覆寫指定的 Amazon S3 儲存貯體中任何符合 sample_employee_data 檔案字首的現有檔案。

SELECT * FROM employees INTO OUTFILE S3 's3://aurora-select-into-s3-pdx/sample_employee_data'
    FIELDS TERMINATED BY ','
    LINES TERMINATED BY '\n'
    MANIFEST ON
    OVERWRITE ON;