本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 連線至 WooCommerce
WooCommerce 是針對以 WordPress 為基礎的網站建置的開放原始碼彈性軟體解決方案。通常用於建立線上電子商務商店。透過此軟體解決方案，任何人都可以將一般網站轉換為功能完整的線上商店。
**Topics**
+ [AWS Glue 支援 WooCommerce](woocommerce-support.md)
+ [包含用於建立和使用連線的 API 操作的政策](woocommerce-configuring-iam-permissions.md)
+ [設定 WooCommerce](woocommerce-configuring.md)
+ [設定 WooCommerce 連線](woocommerce-configuring-connections.md)
+ [從 WooCommerce 實體中讀取](woocommerce-reading-from-entities.md)
+ [WooCommerce 連線選項](woocommerce-connection-options.md)
# AWS Glue 支援 WooCommerce
AWS Glue 支援 WooCommerce，如下所示：
**支援作為來源？**
是。您可以使用 AWS Glue ETL 任務從 WooCommerce 查詢資料。
**支援作為目標？**
否。
**支援的 WooCommerce API 版本**
支援下列 WooCommerce API 版本：
+ v3
# 包含用於建立和使用連線的 API 操作的政策
下列範例政策說明建立和使用 連線所需的 AWS IAM 許可。如果您要建立新角色，請建立包含下列項目的政策：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
如果不想使用上述方法，可選擇使用下列受管 IAM 政策：
+ [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole) – 准許存取各種 AWS Glue 程序代表您執行所需的資源。這些資源包括 AWS Glue Amazon S3、IAM、CloudWatch Logs 和 Amazon EC2。如果您遵循此政策中指定資源的命名慣例，則 AWS Glue 程序具有必要的許可。此政策通常會連接至定義編目程式、工作和開發端點時所指定的角色。
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess) – 當政策連接至 的身分使用 AWS 管理主控台時，授予 AWS Glue 資源的完整存取權。如果您依照此政策中指定的資源命名慣例，使用者就能擁有完整的主控台功能。此政策通常連接到 AWS Glue 主控台的使用者。
# 設定 WooCommerce
您必須先符合下列要求，才能使用 從 WooCommerce AWS Glue 傳輸資料：
## 最低需求
以下是最低要求：
+ 您擁有一個具有 `consumerKey` 和 `consumerSecret` 的 WooCommerce 帳戶。
+ 您的 WooCommerce 帳戶具有包含有效授權的 API 存取。
如果您符合這些要求，就可以 AWS Glue 連線到您的 WooCommerce 帳戶。對於一般連線，您不需要在 WooCommerce 中執行任何其他操作。
# 設定 WooCommerce 連線
WooCommerce 支援自訂身分驗證。如需有關產生自訂授權所需 API 金鑰的公有 WooCommerce 文件，請參閱[身分驗證 – WooCommerce REST API 文件](https://woocommerce.github.io/woocommerce-rest-api-docs/#authentication)。
若要設定 WooCommerce 連線：
1. 在 AWS Secrets Manager 中，建立包含下列詳細資訊的秘密：
+ 對於客戶管理的連線應用程式，機密應包含以 `consumerKey` 和 `consumerSecret` 作為金鑰的連線應用程式消費者機密。注意：您必須在 AWS Glue中為每個連線建立機密。
1. 在 AWS Glue Glue Studio 中，依照下列步驟在 **Data Connections** 下建立連線：
1. 選取**連線類型**時，請選取 WooCommerce。
1. 提供您要連線的 WooCommerce 執行個體的 `INSTANCE_URL`。
1. 選取 AWS Glue 可以擔任並具有下列動作許可的 AWS IAM 角色：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. 選取您要用於此連線`secretName`的 AWS Glue ，以放置字符。
1. 如果想要使用您的網路，請選取網路選項。
1. 授予與您的 AWS Glue 任務相關聯的 IAM 角色讀取 的許可`secretName`。
# 從 WooCommerce 實體中讀取
**必要條件**
您要從中讀取的 WooCommerce 物件。將需要物件名稱，例如優惠券、訂單、產品等。
**來源的支援實體**：
| 實體 | 可以篩選 | 支援限制 | 支援排序依據 | 支援選取 \$1 | 支援分區 |
| --- | --- | --- | --- | --- | --- |
| 優惠券 | 是 | 是 | 是 | 是 | 是 |
| 優惠券總計 | 否 | 否 | 否 | 是 | 否 |
| 客戶總計 | 否 | 否 | 否 | 是 | 否 |
| 順序 | 是 | 是 | 是 | 是 | 是 |
| 訂單總計 | 否 | 否 | 否 | 是 | 否 |
| 付款閘道 | 否 | 否 | 否 | 是 | 否 |
| 產品 | 是 | 是 | 是 | 是 | 是 |
| 產品屬性 | 是 | 是 | 是 | 是 | 是 |
| 產品類別 | 是 | 是 | 是 | 是 | 是 |
| 產品評論 | 是 | 是 | 是 | 是 | 是 |
| 產品運輸類別 | 是 | 是 | 是 | 是 | 是 |
| 產品標籤 | 是 | 是 | 是 | 是 | 是 |
| 產品變化 | 是 | 是 | 是 | 是 | 是 |
| 產品總計 | 否 | 否 | 否 | 是 | 否 |
| 報告 (清單) | 否 | 否 | 否 | 是 | 否 |
| 檢閱總計 | 否 | 否 | 否 | 是 | 否 |
| 銷售報告 | 是 | 否 | 否 | 是 | 否 |
| 運輸方法 | 否 | 否 | 否 | 是 | 否 |
| 運輸區域 | 否 | 否 | 否 | 是 | 否 |
| 運輸區域位置 | 否 | 否 | 否 | 是 | 否 |
| 運算區域方法 | 否 | 否 | 否 | 是 | 否 |
| 稅率 | 是 | 是 | 是 | 是 | 是 |
| 稅種 | 否 | 否 | 否 | 是 | 否 |
| 熱門賣家報告 | 是 | 否 | 否 | 是 | 否 |
**範例**：
```
woocommerce_read = glueContext.create_dynamic_frame.from_options(
connection_type="glue.spark.woocommerce",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "coupon",
"API_VERSION": "v3",
"INSTANCE_URL": "instanceUrl"
}
```
**WooCommerce 實體和欄位詳細資訊**：
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/glue/latest/dg/woocommerce-reading-from-entities.html)
**注意**
在連接器的回應中，Struct 和 List 資料類型會轉換為 String 資料類型，DateTime 資料類型會轉換為 Timestamp。
## 分區查詢
**記錄型分區**：
如果想要在 Spark 中使用並行，可以提供其他 Spark 選項 `NUM_PARTITIONS`。使用這些參數，原始查詢會分區為可由 Spark 任務並行執行的子查詢的 `NUM_PARTITIONS` 數目。
在記錄型分區中，會從 WooCommerce API 中查詢存在的記錄總數，並除以提供的 `NUM_PARTITIONS` 數目。然後，每個子查詢都會同時擷取產生的記錄數目。
+ `NUM_PARTITIONS`：分區數目。
下列實體支援記錄型分區：
+ coupon
+ order
+ product
+ product-attribute
+ product-attribute-term
+ product-category
+ product-review
+ product-shipping-class
+ product-tag
+ product-variation
+ tax-rate
範例：
```
woocommerce_read = glueContext.create_dynamic_frame.from_options(
connection_type="glue.spark.woocommerce",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "coupon",
"API_VERSION": "v3",
"INSTANCE_URL": "instanceUrl"
"NUM_PARTITIONS": "10"
}
```
**記錄型分區**：
原始查詢會分區為 Spark 任務可同時執行的子查詢的 `NUM_PARTITIONS` 數目：
+ `NUM_PARTITIONS`：分區數目。
範例：
```
WooCommerce_read = glueContext.create_dynamic_frame.from_options(
connection_type="WooCommerce",
connection_options={
"connectionName": "connectionName",
"REALMID": "1234567890123456789",
"ENTITY_NAME": "Bill",
"API_VERSION": "v3",
"NUM_PARTITIONS": "10"
}
```
# WooCommerce 連線選項
以下是 WooCommerce 的連線選項：
+ `ENTITY_NAME`(String) - (必要) 用於讀取。WooCommerce 中的物件名稱。
+ `API_VERSION`(String) - (必要) 用於讀取。您想要使用的 WooCommerce Rest API 版本。
+ `REALM_ID`(String) - 一個 ID，其識別您在其中傳送請求的單個 WooCommerce 線上公司。
+ `SELECTED_FIELDS`(List) - 預設：empty(SELECT \$1)。用於讀取。您要為物件選取的資料欄。
+ `FILTER_PREDICATE`(String) - 預設：空白。用於讀取。其應該為 Spark SQL 格式。
+ `QUERY`(String) - 預設：空白。用於讀取。完整的 Spark SQL 查詢。
+ `INSTANCE_URL`(String) - (必要) 有效的 WooCommerce 執行個體 URL，格式為：https://.wpcomstaging.com
+ `NUM_PARTITIONS`(Integer) - 預設：1。用於讀取。要讀取的分區數目。