

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

# 從 Amazon S3 儲存貯體中的文字檔案將資料載入 Amazon Aurora MySQL 資料庫叢集
<a name="AuroraMySQL.Integrating.LoadFromS3"></a><a name="load_from_s3"></a><a name="load_data"></a><a name="load_xml"></a>

您可以使用 `LOAD DATA FROM S3` 或 `LOAD XML FROM S3` 陳述式，從存放在 Amazon S3 儲存貯體的檔案載入資料。在 Aurora MySQL 中，檔案會先儲存在本機磁碟上，然後匯入資料庫。匯入資料庫完成後，系統會刪除本機檔案。

**注意**  
不支援 Aurora Serverless v1 從文字檔案將資料載入資料表。Aurora Serverless v2 則支援。

**Contents**
+ [授權 Aurora 存取 Amazon S3](#AuroraMySQL.Integrating.LoadFromS3.Authorize)
+ [授權在 Amazon Aurora MySQL 中載入資料](#AuroraMySQL.Integrating.LoadFromS3.Grant)
+ [指定 Amazon S3 儲存貯體的路徑 (URI)](#AuroraMySQL.Integrating.LoadFromS3.URI)
+ [LOAD DATA FROM S3](#AuroraMySQL.Integrating.LoadFromS3.Text)
  + [語法](#AuroraMySQL.Integrating.LoadFromS3.Text.Syntax)
  + [Parameters](#AuroraMySQL.Integrating.LoadFromS3.Text.Parameters)
  + [使用資訊清單指定要載入的資料檔案](#AuroraMySQL.Integrating.LoadFromS3.Manifest)
    + [使用 aurora\$1s3\$1load\$1history 資料表來驗證載入的檔案](#AuroraMySQL.Integrating.LoadFromS3.Manifest.History)
  + [範例](#AuroraMySQL.Integrating.LoadFromS3.Text.Examples)
+ [LOAD XML FROM S3](#AuroraMySQL.Integrating.LoadFromS3.XML)
  + [語法](#AuroraMySQL.Integrating.LoadFromS3.XML.Syntax)
  + [Parameters](#AuroraMySQL.Integrating.LoadFromS3.XML.Parameters)

## 授權 Aurora 存取 Amazon S3
<a name="AuroraMySQL.Integrating.LoadFromS3.Authorize"></a>

您必須先授權 Aurora MySQL 資料庫叢集存取 Amazon S3，才能從 Amazon S3 儲存貯體載入資料。

**授權 Aurora MySQL 存取 Amazon S3**

1. 建立 AWS Identity and Access Management (IAM) 政策，提供允許 Aurora MySQL 資料庫叢集存取 Amazon S3 的儲存貯體和物件許可。如需說明，請參閱[建立 IAM 政策來存取 Amazon S3 資源](AuroraMySQL.Integrating.Authorizing.IAM.S3CreatePolicy.md)。
**注意**  
在 Aurora MySQL 3.05 及更高版本中，您可以載入使用客戶受管 AWS KMS keys加密的物件。若要這麼做，請在 IAM 政策中包含 `kms:Decrypt` 許可。如需詳細資訊，請參閱[建立 IAM 政策以存取 AWS KMS資源](AuroraMySQL.Integrating.Authorizing.IAM.KMSCreatePolicy.md)。  
您不需要此許可，即可載入使用 AWS 受管金鑰 或 Amazon S3 受管金鑰 (SSE-S3) 加密的物件。

1. 建立 IAM 角色，並將您於[建立 IAM 政策來存取 Amazon S3 資源](AuroraMySQL.Integrating.Authorizing.IAM.S3CreatePolicy.md)中建立的 IAM 政策連接至新的 IAM 角色。如需說明，請參閱「[建立 IAM 角色以允許 Amazon Aurora 存取 AWS 服務](AuroraMySQL.Integrating.Authorizing.IAM.CreateRole.md)」。

1. 確保資料庫叢集使用自訂資料庫叢集參數群組。

   如需建立自訂資料庫叢集參數群組的詳細資訊，請參閱[在 Amazon Aurora 中建立資料庫叢集參數群組](USER_WorkingWithParamGroups.CreatingCluster.md)。

1. 對於 Aurora MySQL 第 2 版，將 `aurora_load_from_s3_role` 或 `aws_default_s3_role` 資料庫叢集參數設定為新 IAM 角色的 Amazon Resource Name (ARN)。如果 `aurora_load_from_s3_role` 中未指定 IAM 角色，Aurora 會使用 `aws_default_s3_role` 中指定的 IAM 角色。

   對於 Aurora MySQL 第 3 版，請使用 `aws_default_s3_role`。

   如果叢集屬於 Aurora 全球資料庫，請為全球資料庫中的每個 Aurora 叢集設定此參數。雖然 Aurora 全球資料庫中只有主要叢集可以載入資料，但其他叢集可能經由容錯移轉機制提升，而成為主要叢集。

   如需資料庫叢集參數的詳細資訊，請參閱 [Amazon Aurora 資料庫叢集和資料庫執行個體參數](USER_WorkingWithDBClusterParamGroups.md#Aurora.Managing.ParameterGroups)。

1. 若要允許 Aurora MySQL 資料庫叢集的資料庫使用者存取 Amazon S3，請將您在[建立 IAM 角色以允許 Amazon Aurora 存取 AWS 服務](AuroraMySQL.Integrating.Authorizing.IAM.CreateRole.md)中建立的角色與資料庫叢集建立關聯。對於 Aurora 全球資料庫，請將此角色與全球資料庫中的每個 Aurora 叢集建立關聯。如需將 IAM 角色與資料庫叢集建立關聯的相關資訊，請參閱[將 IAM 角色與 Amazon Aurora MySQL 資料庫叢集建立關聯](AuroraMySQL.Integrating.Authorizing.IAM.AddRoleToDBCluster.md)。

1. 設定 Aurora MySQL 資料庫叢集來允許對外連接至 Amazon S3。如需說明，請參閱「[啟用從 Amazon Aurora 到其他服務的網路通訊 AWS](AuroraMySQL.Integrating.Authorizing.Network.md)」。

   如果 資料庫叢集不可公開存取且位於 VPC 公有子網路中，則為私有。您可以建立 S3 閘道端點來存取 S3 儲存貯體。如需詳細資訊，請參閱 [Amazon S3 的閘道端點](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-s3.html)。

    對於 Aurora 全球資料庫，請對全球資料庫中的每個 Aurora 叢集啟用傳出連線。

## 授權在 Amazon Aurora MySQL 中載入資料
<a name="AuroraMySQL.Integrating.LoadFromS3.Grant"></a>

發出 `LOAD DATA FROM S3` 或 `LOAD XML FROM S3` 陳述式的資料庫使用者必須具備特定的角色或權限，才能發出任一陳述式。在 Aurora MySQL 第 3 版中，您授予 `AWS_LOAD_S3_ACCESS` 角色。在 Aurora MySQL 第 2 版中，您授予 `LOAD FROM S3` 權限。根據預設，會將適當的角色或權限授予資料庫叢集的管理使用者。您可以使用下列其中一個陳述式，將此權限授予另一個使用者。

 請針對 Aurora MySQL 第 3 版使用下列陳述式：

```
GRANT AWS_LOAD_S3_ACCESS TO 'user'@'domain-or-ip-address'
```

**提示**  
在 Aurora MySQL 第 3 版中使用角色技術時，您也可以使用 `SET ROLE role_name` 或 `SET ROLE ALL` 陳述式啟用角色。如果您不熟悉 MySQL 8.0 角色系統，您可以在[角色型權限模型](AuroraMySQL.Compare-80-v3.md#AuroraMySQL.privilege-model)進一步了解。如需詳細資訊，請參閱《MySQL 參考手冊》**中的[使用角色](https://dev.mysql.com/doc/refman/8.0/en/roles.html)。  
此僅適用於目前的作用中工作階段。重新連接時，您必須再次執行 `SET ROLE` 陳述式以授予權限。如需詳細資訊，請參閱 *MySQL Reference Manual* (MySQL 參考手冊) 中的 [SET ROLE 陳述式](https://dev.mysql.com/doc/refman/8.0/en/set-role.html)。  
您可以使用 `activate_all_roles_on_login` 資料庫叢集參數，在使用者連線至資料庫執行個體時自動啟動所有角色。設定此參數後，您通常不需要明確呼叫 `SET ROLE` 陳述式，即可啟用角色。如需詳細資訊，請參閱 *MySQL Reference Manual* (MySQL 參考手冊) 中的 [activate\$1all\$1roles\$1on\$1login](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_activate_all_roles_on_login)。  
不過，當不同使用者呼叫預存程序時，您必須在預存程序開始時明確呼叫 `SET ROLE ALL` 以啟用角色。

請針對 Aurora MySQL 第 2 版使用下列陳述式：

```
GRANT LOAD FROM S3 ON *.* TO 'user'@'domain-or-ip-address'
```

`AWS_LOAD_S3_ACCESS` 角色和 `LOAD FROM S3` 權限是 Amazon Aurora MySQL 特定的，而且不適用於外部 MySQL 資料庫或 RDS for MySQL 資料庫執行個體。如果您在 Aurora 資料庫叢集 (複寫來源) 和 MySQL 資料庫 (複寫用戶端) 之間設定複寫，則角色或權限的 `GRANT` 陳述式會導致複寫停止並產生錯誤。您可以放心略過此錯誤並繼續複寫。若要在 RDS for MySQL 執行個體上略過此錯誤，請使用 [ mysql\$1rds\$1skip\$1repl\$1error](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/mysql_rds_skip_repl_error.html) 程序。若要略過外部 MySQL 資料庫上的錯誤，請使用 [slave\$1skip\$1errors](https://dev.mysql.com/doc/refman/5.7/en/replication-options-replica.html#sysvar_slave_skip_errors) 系統變數 (Aurora MySQL 第 2 版) 或 [replica\$1skip\$1errors](https://dev.mysql.com/doc/refman/8.0/en/replication-options-replica.html#sysvar_replica_skip_errors) 系統變數 (Aurora MySQL 第 3 版)。

**注意**  
資料庫使用者必須具有其所載入資料之資料庫的 `INSERT` 權限。

## 指定 Amazon S3 儲存貯體的路徑 (URI)
<a name="AuroraMySQL.Integrating.LoadFromS3.URI"></a>

對存放於 Amazon S3 儲存貯體中的檔案，指定路徑 (URI) 的語法如下。

```
s3-region://amzn-s3-demo-bucket/file-name-or-prefix
```

路徑包含以下值：
+ `region` （選用） – 包含要載入之 Amazon S3 儲存貯 AWS 體的區域。此值是選用的。如果未指定 `region` 值，Aurora 會從資料庫叢集所在同一個區域中的 Amazon S3 載入檔案。
+ `bucket-name` – Amazon S3 儲存貯體的名稱，其中包含要載入的資料。支援表示虛擬資料夾路徑的物件字首。
+ `file-name-or-prefix` – Amazon S3 文字檔案或 XML 檔案的名稱，或表示一或多個要載入之文字檔案或 XML 檔案的字首。您也可以指定資訊清單檔案，以指出一或多個要載入的文字檔案。如需使用資訊清單檔案從 Amazon S3 載入文字檔案的詳細資訊，請參閱[使用資訊清單指定要載入的資料檔案](#AuroraMySQL.Integrating.LoadFromS3.Manifest)。

**複製 S3 儲存貯體中檔案的 URI**

1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)：// 開啟 Amazon S3 主控台。

1. 在導覽窗格中，選擇**儲存貯體**，然後選擇您要複製其 URI 的儲存貯體。

1. 選取您要從 S3 載入的字首或檔案。

1. 選擇**複製 S3 URI**。

## LOAD DATA FROM S3
<a name="AuroraMySQL.Integrating.LoadFromS3.Text"></a>

您可以使用 `LOAD DATA FROM S3` 陳述式從 MySQL [LOAD DATA INFILE](https://dev.mysql.com/doc/refman/8.0/en/load-data.html) 陳述式支援的任何文字檔案格式中載入資料，例如以逗號分隔的文字資料。不支援壓縮檔案。

**注意**  
確定您的 Aurora MySQL 資料庫叢集允許 S3 的傳出連線。如需詳細資訊，請參閱[啟用從 Amazon Aurora 到其他服務的網路通訊 AWS](AuroraMySQL.Integrating.Authorizing.Network.md)。

### 語法
<a name="AuroraMySQL.Integrating.LoadFromS3.Text.Syntax"></a>

```
LOAD DATA [FROM] S3 [FILE | PREFIX | MANIFEST] 'S3-URI'
    [REPLACE | IGNORE]
    INTO TABLE tbl_name
    [PARTITION (partition_name,...)]
    [CHARACTER SET charset_name]
    [{FIELDS | COLUMNS}
        [TERMINATED BY 'string']
        [[OPTIONALLY] ENCLOSED BY 'char']
        [ESCAPED BY 'char']
    ]
    [LINES
        [STARTING BY 'string']
        [TERMINATED BY 'string']
    ]
    [IGNORE number {LINES | ROWS}]
    [(col_name_or_user_var,...)]
    [SET col_name = expr,...]
```

**注意**  
在 Aurora MySQL 版本 3.05 及更高版本中，關鍵字 `FROM` 是選用的。

### Parameters
<a name="AuroraMySQL.Integrating.LoadFromS3.Text.Parameters"></a>

`LOAD DATA FROM S3` 陳述式會使用下列必要和選用參數。您可以在 MySQL 文件的 [LOAD DATA 陳述式](https://dev.mysql.com/doc/refman/8.0/en/load-data.html)中找到某些參數的詳細資訊。

**FILE \$1 PREFIX \$1 MANIFEST**  
識別要從單一檔案、符合指定字首的所有檔案，還是指定資訊清單中的所有檔案來載入資料。`FILE` 是預設值。

**S3-URI**  
指定要載入之文字檔案或資訊清單檔案的 URI，或要使用的 Amazon S3 字首。請使用[指定 Amazon S3 儲存貯體的路徑 (URI)](#AuroraMySQL.Integrating.LoadFromS3.URI)所述的語法來指定 URI。

**REPLACE \$1 IGNORE**  
當輸入資料列與資料庫資料表中現有的資料列具有相同的唯一索引鍵值時，決定要採取什麼動作。  
+ 如果要讓輸入資料列取代資料表中現有的資料列，請指定 `REPLACE`。
+ 如果要捨棄輸入資料列，請指定 `IGNORE`。

**INTO TABLE**  
識別要將輸入資料列載入其中的資料庫資料表名稱。

**PARTITION**  
要求在指定之逗號分隔分割區名稱清單所指出的分割區，插入所有輸入資料列。如果有輸入資料列無法插入其中一個指定的分割區，則陳述式會失敗並傳回錯誤。

**CHARACTER SET**  
識別輸入檔案中資料的字元集。

**FIELDS \$1 COLUMNS**  
識別輸入檔案中的欄位或資料欄如何分隔。依預設以 Tab 鍵分隔欄位。

**LINES**  
識別輸入檔案中的行如何分隔。依預設，行會以換行字元 (`'\n'`) 分隔。

**IGNORE *number* LINES \$1 ROWS**  
指定忽略輸入檔案開頭一定數量的行或資料列。例如，您可以使用 `IGNORE 1 LINES` 來跳過含有欄名稱的起始標頭行，或使用 `IGNORE 2 ROWS` 來跳過輸入檔案中的前兩列資料。如果您也使用 `PREFIX`，`IGNORE` 會略過第一個輸入檔案開頭的特定行數或列數。

**col\$1name\$1or\$1user\$1var, ...**  
指定逗號分隔清單，列出一或多欄名稱，或識別要依名稱載入哪些資料欄的使用者變數。做為此用途的使用者變數名稱必須符合文字檔中的元素名稱，字首為 @。您可以利用使用者變數來存放對應的欄位值，供以後重複使用。  
例如，下載陳述式將輸入檔案的第一欄載入 `table1` 的第一欄，並將 `table_column2` 的 `table1` 欄的值設為第二欄的輸入值除以 100。  

```
LOAD DATA FROM S3 's3://amzn-s3-demo-bucket/data.txt'
    INTO TABLE table1
    (column1, @var1)
    SET table_column2 = @var1/100;
```

**SET**  
指定逗號分隔清單，列出指派操作，其會將資料表中資料欄的值設為不包括在輸入檔案中的值。  
例如，下載陳述式將 `table1` 的前兩欄設為輸入檔案中前兩欄的值，然後將 `column3` 中的 `table1` 的值設為目前的時間戳記。  

```
LOAD DATA FROM S3  's3://amzn-s3-demo-bucket/data.txt'
    INTO TABLE table1
    (column1, column2)
    SET column3 = CURRENT_TIMESTAMP;
```
您可以在 `SET` 指派的右邊使用子查詢。如果子查詢會傳回值來指派給一個欄，則您只能使用純量子查詢。您也不能使用子查詢來從載入的資料表中選取。

如果您從 Amazon S3 儲存貯體載入資料，則無法使用 `LOAD DATA FROM S3` 陳述式的 `LOCAL` 關鍵字。

### 使用資訊清單指定要載入的資料檔案
<a name="AuroraMySQL.Integrating.LoadFromS3.Manifest"></a>

您可以使用 `LOAD DATA FROM S3` 陳述式搭配 `MANIFEST` 關鍵字，以指定 JSON 格式的資訊清單檔案，其中列出要在資料庫叢集的資料表中載入的文字檔案。

下列 JSON 結構描述說明資訊清單檔案的格式和內容。

```
{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "additionalProperties": false,
    "definitions": {},
    "id": "Aurora_LoadFromS3_Manifest",
    "properties": {
        "entries": {
            "additionalItems": false,
            "id": "/properties/entries",
            "items": {
                "additionalProperties": false,
                "id": "/properties/entries/items",
                "properties": {
                    "mandatory": {
                        "default": "false",
                        "id": "/properties/entries/items/properties/mandatory",
                        "type": "boolean"
                    },
                    "url": {
                        "id": "/properties/entries/items/properties/url",
                        "maxLength": 1024,
                        "minLength": 1,
                        "type": "string"
                    }
                },
                "required": [
                    "url"
                ],
                "type": "object"
            },
            "type": "array",
            "uniqueItems": true
        }
    },
    "required": [
        "entries"
    ],
    "type": "object"
}
```

資訊清單檔案中的每個 `url` 必須指定 URL 和儲存貯體名稱，以及檔案的完整物件路徑，而不只是字首。您可以使用資訊清單從不同儲存貯體、不同區域載入檔案，或載入不共用相同字首的檔案。如果 URL 中未指定某個區域，則會使用目標 Aurora 資料庫叢集的區域。下列範例顯示的資訊清單檔案會從不同儲存貯體載入四個檔案。

```
{
  "entries": [
    {
      "url":"s3://aurora-bucket/2013-10-04-customerdata", 
      "mandatory":true
    },
    {
      "url":"s3-us-west-2://aurora-bucket-usw2/2013-10-05-customerdata",
      "mandatory":true
    },
    {
      "url":"s3://aurora-bucket/2013-10-04-customerdata", 
      "mandatory":false
    },
    {
      "url":"s3://aurora-bucket/2013-10-05-customerdata"
    }
  ]
}
```

選用的 `mandatory` 旗標指定如果找不到檔案時，`LOAD DATA FROM S3` 是否傳回錯誤。`mandatory` 旗標預設為 `false`。無論 `mandatory` 如何設定，如果找不到檔案，`LOAD DATA FROM S3` 就會終止。

資訊清單檔案可以有任何副檔名。下列範例會搭配上一個範例中的資訊清單 (名為 `LOAD DATA FROM S3`) 執行 **customer.manifest** 陳述式。

```
LOAD DATA FROM S3 MANIFEST 's3-us-west-2://aurora-bucket/customer.manifest'
    INTO TABLE CUSTOMER
    FIELDS TERMINATED BY ','
    LINES TERMINATED BY '\n'
    (ID, FIRSTNAME, LASTNAME, EMAIL);
```

陳述式完成之後，每個成功載入的檔案都有一個項目寫入 `aurora_s3_load_history` 資料表中。

#### 使用 aurora\$1s3\$1load\$1history 資料表來驗證載入的檔案
<a name="AuroraMySQL.Integrating.LoadFromS3.Manifest.History"></a>

每個成功的 `LOAD DATA FROM S3` 陳述式會針對每個已載入的檔案，以一個項目更新 `aurora_s3_load_history` 結構描述中的 `mysql` 資料表。

執行 `LOAD DATA FROM S3` 陳述式之後，您可以查詢 `aurora_s3_load_history` 資料表來驗證已載入哪些檔案。若要查看反覆運算之陳述式所載入的檔案，請依陳述式中使用的資訊清單檔案，使用 `WHERE` 子句來篩選 Amazon S3 URI 上的記錄。如果您之前已用過相同的資訊清單檔案，請使用 `timestamp` 欄位來篩選結果。

```
select * from mysql.aurora_s3_load_history where load_prefix = 'S3_URI';
```

下表描述 `aurora_s3_load_history` 資料表中的欄位。


| 欄位 | 描述 | 
| --- | --- | 
| `load_prefix` |  Load 陳述式中指定的 URI。此 URI 可以映射至下列任何一項： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Integrating.LoadFromS3.html)  | 
|  `file_name`  |  使用 `load_prefix` 欄位所指定的 URI，從 Amazon S3 載入到 Aurora 的檔案名稱。  | 
| `version_number` |  由 `file_name` 欄位所識別之已載入檔案的版本編號 (如果 Amazon S3 儲存貯體有版本編號)。  | 
|  `bytes_loaded`  |  載入的檔案大小 (以位元組為單位)。  | 
| `load_timestamp`  |  `LOAD DATA FROM S3` 陳述式完成時的時間戳記。  | 

### 範例
<a name="AuroraMySQL.Integrating.LoadFromS3.Text.Examples"></a>

下列陳述式從 Aurora 資料庫叢集所在同一個區域中的 Amazon S3 儲存貯體載入資料。此陳述式從 *amzn-s3-demo-bucket* Amazon S3 儲存貯體中的檔案 `customerdata.txt` 讀取逗號分隔資料，然後將資料載入資料表 `store-schema.customer-table`。

```
LOAD DATA FROM S3 's3://amzn-s3-demo-bucket/customerdata.csv' 
    INTO TABLE store-schema.customer-table
    FIELDS TERMINATED BY ','
    LINES TERMINATED BY '\n'
    (ID, FIRSTNAME, LASTNAME, ADDRESS, EMAIL, PHONE);
```

下列陳述式從不是位於 Aurora 資料庫叢集所在區域中的 Amazon S3 儲存貯體載入資料。此陳述式在 `us-west-2` 區域的 *amzn-s3-demo-bucket* Amazon S3 儲存貯體中，從符合 `employee-data` 物件字首的所有檔案中讀取逗號分隔資料，然後將資料載入 `employees` 資料表。

```
LOAD DATA FROM S3 PREFIX 's3-us-west-2://amzn-s3-demo-bucket/employee_data'
    INTO TABLE employees
    FIELDS TERMINATED BY ','
    LINES TERMINATED BY '\n'
    (ID, FIRSTNAME, LASTNAME, EMAIL, SALARY);
```

下列陳述式從名為 q1\$1sales.json 的 JSON 資訊清單檔案所指定的檔案中，將資料載入 `sales` 資料表。

```
LOAD DATA FROM S3 MANIFEST 's3-us-west-2://amzn-s3-demo-bucket1/q1_sales.json'
    INTO TABLE sales
    FIELDS TERMINATED BY ','
    LINES TERMINATED BY '\n'
    (MONTH, STORE, GROSS, NET);
```

## LOAD XML FROM S3
<a name="AuroraMySQL.Integrating.LoadFromS3.XML"></a>

您可以使用 `LOAD XML FROM S3` 陳述式，從存放在 Amazon S3 儲存貯體的 XML 檔案 (有三種不同的 XML 格式) 載入資料：
+ 欄名稱做為 `<row>` 元素的屬性。屬性值指出資料表欄位的內容。

  ```
  <row column1="value1" column2="value2" .../>
  ```
+ 欄名稱做為 `<row>` 元素的子元素。子元素的值指出資料表欄位的內容。

  ```
  <row>
    <column1>value1</column1>
    <column2>value2</column2>
  </row>
  ```
+ 在 `name` 元素的 `<field>` 元素中，`<row>` 屬性中的欄名稱。`<field>` 元素的值指出資料表欄位的內容。

  ```
  <row>
    <field name='column1'>value1</field>
    <field name='column2'>value2</field>
  </row>
  ```

### 語法
<a name="AuroraMySQL.Integrating.LoadFromS3.XML.Syntax"></a>

```
LOAD XML FROM S3 'S3-URI'
    [REPLACE | IGNORE]
    INTO TABLE tbl_name
    [PARTITION (partition_name,...)]
    [CHARACTER SET charset_name]
    [ROWS IDENTIFIED BY '<element-name>']
    [IGNORE number {LINES | ROWS}]
    [(field_name_or_user_var,...)]
    [SET col_name = expr,...]
```

### Parameters
<a name="AuroraMySQL.Integrating.LoadFromS3.XML.Parameters"></a>

`LOAD XML FROM S3` 陳述式會使用下列必要和選用參數。您可以在 MySQL 文件的 [LOAD XML 陳述式](https://dev.mysql.com/doc/refman/8.0/en/load-xml.html)中找到某些參數的詳細資訊。

**FILE \$1 PREFIX**  
識別要從單一檔案還是從符合指定字首的所有檔案中載入資料。`FILE` 是預設值。

**REPLACE \$1 IGNORE**  
當輸入資料列與資料庫資料表中現有的資料列具有相同的唯一索引鍵值時，決定要採取什麼動作。  
+ 如果要讓輸入資料列取代資料表中現有的資料列，請指定 `REPLACE`。
+ 如果要捨棄輸入資料列，請指定 `IGNORE`。`IGNORE` 是預設值。

**INTO TABLE**  
識別要將輸入資料列載入其中的資料庫資料表名稱。

**PARTITION**  
要求在指定之逗號分隔分割區名稱清單所指出的分割區，插入所有輸入資料列。如果有輸入資料列無法插入其中一個指定的分割區，則陳述式會失敗並傳回錯誤。

**CHARACTER SET**  
識別輸入檔案中資料的字元集。

**ROWS IDENTIFIED BY**  
識別元素名稱，其會識別輸入檔案中的一列。預設值為 `<row>`。

**IGNORE *number* LINES \$1 ROWS**  
指定忽略輸入檔案開頭一定數量的行或資料列。例如，您可以使用 `IGNORE 1 LINES` 來跳過文字檔案的第一行，或使用 `IGNORE 2 ROWS` 來跳過輸入 XML 中的前兩列資料。

**field\$1name\$1or\$1user\$1var, ...**  
指定逗號分隔清單，列出一或多個 XML 元素名稱，或識別要依名稱載入哪些元素的使用者變數。做為此用途的使用者變數名稱必須符合 XML 檔案中的元素名稱，字首為 @。您可以利用使用者變數來存放對應的欄位值，供以後重複使用。  
例如，下載陳述式將輸入檔案的第一欄載入 `table1` 的第一欄，並將 `table_column2` 的 `table1` 欄的值設為第二欄的輸入值除以 100。  

```
LOAD XML FROM S3 's3://amzn-s3-demo-bucket/data.xml'
   INTO TABLE table1
   (column1, @var1)
   SET table_column2 = @var1/100;
```

**SET**  
指定逗號分隔清單，列出指派操作，其會將資料表中資料欄的值設為不包括在輸入檔案中的值。  
例如，下載陳述式將 `table1` 的前兩欄設為輸入檔案中前兩欄的值，然後將 `column3` 中的 `table1` 的值設為目前的時間戳記。  

```
LOAD XML FROM S3 's3://amzn-s3-demo-bucket/data.xml'
   INTO TABLE table1
   (column1, column2)
   SET column3 = CURRENT_TIMESTAMP;
```
您可以在 `SET` 指派的右邊使用子查詢。如果子查詢會傳回值來指派給一個欄，則您只能使用純量子查詢。您也不能使用子查詢，從載入的資料表中選取。