本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 選擇哪些 AWS DataSync 傳輸 AWS DataSync 可讓您選擇要傳輸的內容，以及您希望資料處理的方式。某些選項包括： + 使用資訊清單傳輸檔案或物件的確切清單。 + 使用篩選條件在傳輸中包含或排除特定類型的資料。 + 對於重複傳輸，僅移動自上次傳輸以來變更的資料 + 覆寫目的地位置中的資料，以符合來源位置中的內容。 + 選擇要在儲存位置之間保留哪些檔案或物件中繼資料。 **Topics** + [使用資訊清單傳輸特定檔案或物件](transferring-with-manifest.md) + [使用篩選條件傳輸特定檔案、物件和資料夾](filtering.md) + [了解 DataSync 如何處理檔案和物件中繼資料](metadata-copied.md) + [由 複製的連結和目錄 AWS DataSync](special-files-copied.md) + [設定如何處理檔案、物件和中繼資料](configure-metadata.md) # 使用資訊清單傳輸特定檔案或物件 *資訊清單*是您要 AWS DataSync 傳輸的檔案或物件清單。例如，DataSync 不需要傳輸 S3 儲存貯體中所有可能具有數百萬個物件的內容，而只會傳輸您在資訊清單中列出的物件。 資訊清單類似於[篩選條件](filtering.md)，但可讓您確切識別要傳輸哪些檔案或物件，而不是符合篩選條件模式的資料。 **注意** 具有增強型模式任務的資訊清單檔案允許的大小上限為 20 GB。 ## 建立資訊清單 資訊清單是逗號分隔值 (CSV) 格式的檔案，列出您要 DataSync 傳輸之來源位置中的檔案或物件。如果您的來源是 S3 儲存貯體，您也可以包含要傳輸的物件版本。 **Topics** + [指導方針](#transferring-with-manifest-guidelines) + [範例資訊清單](#manifest-examples) ### 指導方針 使用這些準則來協助您建立可搭配 DataSync 使用的資訊清單。 ------ #### [ Do ] + 指定您要傳輸之每個檔案或物件的完整路徑。 您無法僅指定意圖轉移其所有內容的目錄或資料夾。對於這些情況，請考慮使用[包含篩選條件](filtering.md)而非資訊清單。 + 請確定每個檔案或物件路徑與您在設定 DataSync 來源位置時指定的掛載路徑、資料夾、目錄或字首相關。 例如，假設您使用名為 的字首[來設定 S3 位置](create-s3-location.md#create-s3-location-how-to)`photos`。該字首包含您要傳輸`my-picture.png`的物件。在資訊清單中，您接著只需要指定物件 (`my-picture.png`) 而非字首和物件 (`photos/my-picture.png`)。 + 若要指定 Amazon S3 物件版本 IDs，請使用逗號分隔物件的路徑和版本 ID。 下列範例顯示包含兩個欄位的資訊清單項目。第一個欄位包含名為 的物件`picture1.png`。第二個欄位以逗號分隔，並包含 的版本 ID`111111`： ``` picture1.png,111111 ``` + 在下列情況下使用引號： + 當路徑包含特殊字元 （逗號、引號和行尾） 時： `"filename,with,commas.txt"` + 當路徑跨越多行時： ``` "this is a filename.txt" ``` + 當路徑包含引號時： `filename""with""quotes.txt` 這表示名為 的路徑`filename"with"quotes.txt`。 這些引號規則也適用於版本 ID 欄位。一般而言，如果資訊清單欄位有引號，您必須使用另一個引號逸出它。 + 使用新行分隔每個檔案或物件項目。 您可以使用 Linux （換行或換行） 或 Windows （換行後接換行） 樣式換行來分隔行。 + 儲存資訊清單 （例如， `my-manifest.csv`或 `my-manifest.txt`)。 + 將資訊清單上傳至 [DataSync 可存取](#transferring-with-manifest-access)的 S3 儲存貯體。 此儲存貯體不必位於您使用 DataSync 的相同 AWS 區域 或 帳戶中。 ------ #### [ Don't ] + 僅指定旨在傳輸其所有內容的目錄或資料夾。 資訊清單只能包含您要傳輸之檔案或物件的完整路徑。如果您將來源位置設定為使用特定掛載路徑、資料夾、目錄或字首，則不需要將其包含在資訊清單中。 + 指定超過 4，096 個字元的檔案或物件路徑。 + 指定超過 1，024 個位元組的檔案路徑、物件路徑或 Amazon S3 物件版本 ID。 + 指定重複的檔案或物件路徑。 + 如果您的來源位置不是 S3 儲存貯體，請包含物件版本 ID。 + 在資訊清單項目中包含兩個以上的欄位。 項目只能包含檔案或物件路徑，以及 （如適用） Amazon S3 物件版本 ID。 + 包含不符合 UTF-8 編碼的字元。 + 在引號外的輸入欄位中包含意外空格。 ------ ### 範例資訊清單 使用這些範例來協助您建立可搭配 DataSync 使用的資訊清單。 **具有完整檔案或物件路徑的資訊清單** 下列範例顯示資訊清單，其中包含要傳輸的完整檔案或物件路徑。 ``` photos/picture1.png photos/picture2.png photos/picture3.png ``` **僅具有物件索引鍵的資訊清單** 下列範例顯示資訊清單，其中包含要從 Amazon S3 來源位置傳輸的物件。由於[位置是以](create-s3-location.md#create-s3-location-how-to)字首 設定`photos`，因此只會指定物件金鑰。 ``` picture1.png picture2.png picture3.png ``` **具有物件路徑和版本 IDs清單** 下列資訊清單範例中的前兩個項目包含要傳輸的特定 Amazon S3 物件版本。 ``` photos/picture1.png,111111 photos/picture2.png,121212 photos/picture3.png ``` **帶有 UTF-8 字元的資訊清單** 下列範例顯示包含 UTF-8 字元的檔案資訊清單。 ``` documents/résumé1.pdf documents/résumé2.pdf documents/résumé3.pdf ``` ## 提供對資訊清單的 DataSync 存取權 您需要一個 AWS Identity and Access Management (IAM) 角色，讓 DataSync 存取 S3 儲存貯體中的資訊清單。此角色必須包含下列許可： + `s3:GetObject` + `s3:GetObjectVersion` 您可以在 DataSync 主控台中自動產生此角色，或自行建立角色。 **注意** 如果您的資訊清單位於不同的 AWS 帳戶中，您必須手動建立此角色。 ### 自動建立 IAM 角色 在主控台中建立或啟動傳輸任務時，DataSync 可以使用存取資訊清單所需的 `s3:GetObject`和 `s3:GetObjectVersion`許可，為您建立 IAM 角色。 **自動建立角色所需的許可** 若要自動建立角色，請確定您用來存取 DataSync 主控台的角色具有下列許可： + `iam:CreateRole` + `iam:CreatePolicy` + `iam:AttachRolePolicy` ### 建立 IAM 角色 （相同帳戶） 您可以手動建立 DataSync 存取資訊清單所需的 IAM 角色。下列指示假設您使用 DataSync AWS 帳戶 的所在位置與資訊清單的 S3 儲存貯體所在的位置相同。 1. 前往 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 IAM 主控台。 1. 在左側導覽窗格的**存取管理**下，選擇**角色**，然後選擇**建立角色**。 1. 在**選取信任的實體**頁面上，針對**信任的實體類型**，選擇 **AWS 服務**。 1. 針對**使用案例**，在下拉式清單中選擇 **DataSync**，然後選取 **DataSync**。選擇**下一步**。 1. 在 **Add permissions** (新增許可) 頁面上，選擇 **Next** (下一步)。為您的角色命名，然後選擇**建立角色**。 1. 在**角色**頁面上，搜尋您剛建立的角色，然後選擇其名稱。 1. 在角色的詳細資訊頁面上，選擇**許可**索引標籤。選擇**新增許可**，然後選擇**建立內嵌政策**。 1. 選擇 **JSON** 索引標籤，並將下列範例政策貼到政策編輯器中： ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [{ "Sid": "DataSyncAccessManifest", "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectVersion" ], "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/my-manifest.csv" }] } ``` ------ 1. 在您剛貼上的範例政策中，將下列值取代為您自己的值： 1. `amzn-s3-demo-bucket` 將 取代為託管資訊清單的 S3 儲存貯體名稱。 1. `my-manifest.csv` 將 取代為您資訊清單的檔案名稱。 1. 選擇**下一步**。為您的政策命名，然後選擇**建立政策**。 1. （建議） 若要防止[跨服務混淆代理人問題](cross-service-confused-deputy-prevention.md)，請執行下列動作： 1. 在角色的詳細資訊頁面上，選擇**信任關係**索引標籤。選擇**編輯信任政策**。 1. 使用以下範例更新信任政策，其中包含 `aws:SourceArn`和 `aws:SourceAccount`全域條件內容索引鍵： ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "datasync.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "555555555555" }, "ArnLike": { "aws:SourceArn": "arn:aws:datasync:us-east-1:555555555555:*" } } } ] } ``` ------ + `account-id` 使用 DataSync 所在的 AWS 帳戶 ID 取代每個執行個體。 + `region` 將 取代為您使用 DataSync AWS 區域 的 。 1. 選擇**更新政策**。 您已建立允許 DataSync 存取資訊清單的 IAM 角色。在[建立](#manifest-creating-task)或[啟動](#manifest-starting-task)任務時指定此角色。 ### 建立 IAM 角色 （不同的帳戶） 如果您的資訊清單位於屬於不同 的 S3 儲存貯體中 AWS 帳戶，您必須手動建立 DataSync 用來存取資訊清單的 IAM 角色。然後，在 AWS 帳戶 資訊清單所在的 中，您需要在 S3 儲存貯體政策中包含 角色。 #### 建立 角色 1. 前往 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 IAM 主控台。 1. 在左側導覽窗格的**存取管理**下，選擇**角色**，然後選擇**建立角色**。 1. 在**選取信任的實體**頁面上，針對**信任的實體類型**，選擇 **AWS 服務**。 1. 針對**使用案例**，在下拉式清單中選擇 **DataSync**，然後選取 **DataSync**。選擇**下一步**。 1. 在 **Add permissions** (新增許可) 頁面上，選擇 **Next** (下一步)。為您的角色命名，然後選擇**建立角色**。 1. 在**角色**頁面上，搜尋您剛建立的角色，然後選擇其名稱。 1. 在角色的詳細資訊頁面上，選擇**許可**索引標籤。選擇**新增許可**，然後選擇**建立內嵌政策**。 1. 選擇 **JSON** 索引標籤，並將下列範例政策貼到政策編輯器中： ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [{ "Sid": "DataSyncAccessManifest", "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectVersion" ], "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/my-manifest.csv" }] } ``` ------ 1. 在您剛貼上的範例政策中，將下列值取代為您自己的值： 1. `amzn-s3-demo-bucket` 將 取代為託管資訊清單的 S3 儲存貯體名稱。 1. `my-manifest.csv` 將 取代為您資訊清單的檔案名稱。 1. 選擇**下一步**。為您的政策命名，然後選擇**建立政策**。 1. （建議） 若要防止[跨服務混淆代理人問題](cross-service-confused-deputy-prevention.md)，請執行下列動作： 1. 在角色的詳細資訊頁面上，選擇**信任關係**索引標籤。選擇**編輯信任政策**。 1. 使用以下範例更新信任政策，其中包含 `aws:SourceArn`和 `aws:SourceAccount`全域條件內容索引鍵： ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "datasync.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "000000000000" }, "ArnLike": { "aws:SourceArn": "arn:aws:datasync:us-east-1:000000000000:*" } } } ] } ``` ------ + `account-id` 使用 DataSync 所在的 AWS 帳戶 ID 取代 的每個執行個體。 + `region` 將 取代為您使用 DataSync AWS 區域 的 。 1. 選擇**更新政策**。 您已建立可以包含在 S3 儲存貯體政策中的 IAM 角色。 #### 使用 角色更新您的 S3 儲存貯體政策 建立 IAM 角色之後，您必須將其新增至 AWS 帳戶 資訊清單所在的另一個 中的 S3 儲存貯體政策。 1. 在 中 AWS 管理主控台，使用您 Manfiest 的 S3 儲存貯體切換到帳戶。 1. 開啟位於 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 的 Amazon S3 主控台。 1. 在儲存貯體的詳細資訊頁面上，選擇**許可**索引標籤。 1. 在**儲存貯體政策**下，選擇**編輯**並執行下列動作來修改 S3 儲存貯體政策： 1. 更新編輯器中的內容，以包含下列政策陳述式： ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "DataSyncAccessManifestBucket", "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectVersion" ], "Resource": "arn:aws:s3:::amzn-s3-demo-bucket" } ] } ``` ------ 1. `account-id` 將 取代為您使用 DataSync 之帳戶的 AWS 帳戶 ID。 1. `datasync-role` 將 取代為您剛建立的 IAM 角色，以允許 DataSync 存取您的資訊清單。 1. `amzn-s3-demo-bucket` 將 取代為在另一個 中託管資訊清單的 S3 儲存貯體名稱 AWS 帳戶。 1. 選擇**儲存變更**。 您已建立 IAM 角色，允許 DataSync 存取您在其他帳戶中的資訊清單。在[建立](#manifest-creating-task)或[啟動](#manifest-starting-task)任務時指定此角色。 ## 在建立任務時指定資訊清單 您可以指定您要 DataSync 在建立任務時使用的資訊清單。 ### 使用 DataSync 主控台 1. 在 https：//[https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) 開啟 AWS DataSync 主控台。 1. 在左側導覽窗格中，選擇**任務**，然後選擇**建立任務**。 1. 設定任務的來源和目的地位置。 如需詳細資訊，請參閱[我可以將資料傳輸到哪裡 AWS DataSync？](working-with-locations.md) 1. 針對**要掃描的內容**，選擇**特定檔案、物件和資料夾**，然後選取**使用資訊清單**。 1. 針對 **S3 URI**，選擇託管在 S3 儲存貯體上的資訊清單。 或者，您可以輸入 URI （例如，`s3://bucket/prefix/my-manifest.csv`)。 1. 針對**物件版本**，選擇您希望 DataSync 使用的資訊清單版本。 根據預設，DataSync 會使用物件的最新版本。 1. 對於**資訊清單存取角色**，請執行下列其中一項操作： + 選擇**自動產生** DataSync，以自動建立具有存取 S3 儲存貯體中資訊清單所需許可的 IAM 角色。 + 選擇可存取資訊清單的現有 IAM 角色。 如需詳細資訊，請參閱[提供對資訊清單的 DataSync 存取權](#transferring-with-manifest-access)。 1. 設定您需要的任何其他任務設定，然後選擇**下一步**。 1. 選擇 **Create task (建立任務)**。 ### 使用 AWS CLI 1. 複製下列`create-task`命令： ``` aws datasync create-task \ --source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \ --destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \ --manifest-config { "Source": { "S3": { "ManifestObjectPath": "s3-object-key-of-manifest", "BucketAccessRoleArn": "bucket-iam-role", "S3BucketArn": "amzn-s3-demo-bucket-arn", "ManifestObjectVersionId": "manifest-version-to-use" } } } ``` 1. 針對 `--source-location-arn` 參數，指定您要從中傳輸資料之位置的 Amazon Resource Name (ARN)。 1. 針對 `--destination-location-arn` 參數，指定您要傳輸資料之位置的 ARN。 1. 針對 `--manifest-config` 參數，請執行下列動作： + `ManifestObjectPath` – 指定資訊清單的 S3 物件金鑰。 + `BucketAccessRoleArn` – 指定允許 DataSync 存取 S3 儲存貯體中資訊清單的 IAM 角色。 如需詳細資訊，請參閱[提供對資訊清單的 DataSync 存取權](#transferring-with-manifest-access)。 + `S3BucketArn` – 指定託管資訊清單之 S3 儲存貯體的 ARN。 + `ManifestObjectVersionId` – 指定您希望 DataSync 使用的資訊清單版本。 根據預設，DataSync 會使用物件的最新版本。 1. 執行 `create-task`命令來建立您的任務。 當您準備好時，可以[開始傳輸任務](run-task.md)。 ## 在開始任務時指定資訊清單 您可以指定您希望 DataSync 在執行任務時使用的資訊清單。 ### 使用 DataSync 主控台 1. 在 https：//[https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) 開啟 AWS DataSync 主控台。 1. 在左側導覽窗格中，選擇**任務**，然後選擇您要開始的任務。 1. 在任務概觀頁面中，選擇**開始**，然後選擇**從覆寫選項開始**。 1. 針對**要掃描的內容**，選擇**特定檔案、物件和資料夾**，然後選取**使用資訊清單**。 1. 針對 **S3 URI**，選擇託管在 S3 儲存貯體上的資訊清單。 或者，您可以輸入 URI （例如，`s3://bucket/prefix/my-manifest.csv`)。 1. 針對**物件版本**，選擇您希望 DataSync 使用的資訊清單版本。 根據預設，DataSync 會使用物件的最新版本。 1. 對於**資訊清單存取角色**，請執行下列其中一項操作： + 選擇**自動產生** DataSync 以自動建立 IAM 角色，以存取 S3 儲存貯體中的資訊清單。 + 選擇可存取資訊清單的現有 IAM 角色。 如需詳細資訊，請參閱[提供對資訊清單的 DataSync 存取權](#transferring-with-manifest-access)。 1. 選擇**開始**以開始轉移。 ### 使用 AWS CLI 1. 複製下列`start-task-execution`命令： ``` aws datasync start-task-execution \ --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh \ --manifest-config { "Source": { "S3": { "ManifestObjectPath": "s3-object-key-of-manifest", "BucketAccessRoleArn": "bucket-iam-role", "S3BucketArn": "amzn-s3-demo-bucket-arn", "ManifestObjectVersionId": "manifest-version-to-use" } } } ``` 1. 針對 `--task-arn` 參數，指定您要啟動之任務的 Amazon Resource Name (ARN)。 1. 針對 `--manifest-config` 參數，請執行下列動作： + `ManifestObjectPath` – 指定資訊清單的 S3 物件金鑰。 + `BucketAccessRoleArn` – 指定允許 DataSync 存取 S3 儲存貯體中資訊清單的 IAM 角色。 如需詳細資訊，請參閱[提供對資訊清單的 DataSync 存取權](#transferring-with-manifest-access)。 + `S3BucketArn` – 指定託管資訊清單之 S3 儲存貯體的 ARN。 + `ManifestObjectVersionId` – 指定您希望 DataSync 使用的資訊清單版本。 根據預設，DataSync 會使用物件的最新版本。 1. 執行 `start-task-execution`命令以開始傳輸。 ## 限制 + 您無法將資訊清單與[篩選條件](filtering.md)一起使用。 + 您無法只指定旨在傳輸其所有內容的目錄或資料夾。對於這些情況，請考慮使用[包含篩選條件](filtering.md)而非資訊清單。 + 您無法使用**保留已刪除的檔案**任務選項 (`PreserveDeletedFiles`在 [API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles) 中） 來[維護目的地中不在來源中的檔案或物件](configure-metadata.md)。DataSync 只會傳輸資訊清單中列出的內容，而不會刪除目的地中的任何內容。 ## 疑難排解 **與 `HeadObject`或 相關的錯誤 `GetObjectTagging`** 如果您要從 S3 儲存貯體傳輸具有特定版本 IDs物件，您可能會看到與 `HeadObject`或 相關的錯誤`GetObjectTagging`。例如，以下是與 相關的錯誤`GetObjectTagging`： ``` [WARN] Failed to read metadata for file /picture1.png (versionId: 111111): S3 Get Object Tagging Failed [ERROR] S3 Exception: op=GetObjectTagging photos/picture1.png, code=403, type=15, exception=AccessDenied, msg=Access Denied req-hdrs: content-type=application/xml, x-amz-api-version=2006-03-01 rsp-hdrs: content-type=application/xml, date=Wed, 07 Feb 2024 20:16:14 GMT, server=AmazonS3, transfer-encoding=chunked, x-amz-id-2=IOWQ4fDEXAMPLEQM+ey7N9WgVhSnQ6JEXAMPLEZb7hSQDASK+Jd1vEXAMPLEa3Km, x-amz-request-id=79104EXAMPLEB723 ``` 如果您看到這些錯誤，請驗證 DataSync 用來存取 S3 來源位置的 IAM 角色具有下列許可： + `s3:GetObjectVersion` + `s3:GetObjectVersionTagging` 如果您需要使用這些許可更新角色，請參閱 [為 DataSync 建立 IAM 角色以存取您的 Amazon S3 位置](create-s3-location.md#create-role-manually)。 **錯誤：`ManifestFileDoesNotExist`** 此錯誤表示在來源找不到資訊清單內的檔案。檢閱建立資訊清單的[指導方針](#transferring-with-manifest-guidelines)。 ## 後續步驟 如果您尚未開始任務，請[啟動您的任務](run-task.md)。否則，請[監控任務的活動](monitoring-overview.md)。 # 使用篩選條件傳輸特定檔案、物件和資料夾 AWS DataSync 可讓您套用篩選條件，以在傳輸中包含或排除來源位置的資料。例如，如果您不想傳輸結尾為 的暫存檔案`.tmp`，您可以建立排除篩選條件，讓這些檔案不會前往目的地位置。 您可以使用排除的組合，並在相同的傳輸任務中包含篩選條件。如果您修改任務的篩選條件，這些變更會在您下次執行任務時套用。 ## 篩選詞彙、定義和語法 熟悉與 DataSync 篩選相關的概念： **篩選條件 ** 組成特定篩選條件的整個字串 （例如 `*.tmp``|``*.temp`或 `/folderA|/folderB`)。 篩選條件是由使用管道 (\$1) 分隔的模式組成。當您在 DataSync 主控台中新增模式時，不需要分隔符號，因為您分別新增每個模式。 篩選條件區分大小寫。例如，篩選條件`/folderA`不符合 `/FolderA`。 **模式** 篩選條件的模式。例如， `*.tmp` 是屬於`*.tmp``|``*.temp`篩選條件的模式。如果您的篩選條件有多個模式，您可以使用管道 (\$1) 分隔每個模式。 **資料夾** + 所有篩選條件皆相對於來源位置路徑。例如，假設您在建立來源位置和任務時將 指定`/my_source/`為來源路徑，並指定包含篩選條件 `/transfer_this/`。在此情況下，DataSync 只會傳輸目錄`/my_source/transfer_this/`及其內容。 + 若要直接在來源位置下方指定資料夾，請在資料夾名稱前面包含正斜線 (/)。在之前的範例中，模式使用 `/transfer_this` 而非 `transfer_this`。 + DataSync 會以相同方式解譯下列模式，並同時符合資料夾及其內容。 `/dir` `/dir/` + 當您在 Amazon S3 儲存貯體之間傳輸資料時，DataSync 會將物件金鑰中的`/`字元視為檔案系統上資料夾的同等項目。 **特殊字元** 以下是可用於篩選條件的特殊字元。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/filtering.html) ## 範例篩選條件 下列範例顯示您可以搭配 DataSync 使用的常見篩選條件。 **注意** 您可以在篩選條件中使用多少字元有限制。如需詳細資訊，請參閱[DataSync 配額](datasync-limits.md#task-hard-limits)。 **從來源位置排除一些資料夾** 在某些情況下，您想要排除來源位置中的資料夾，以免它們複製到目的地位置。例如，如果您有臨時work-in-progress資料夾，您可以使用如下篩選條件： `*/.temp` 若要排除具有類似內容 （例如 `/reports2021`和 `/reports2022)`) 的資料夾，您可以使用排除篩選條件，如下所示： `/reports*` 若要排除檔案階層中任何層級的資料夾，您可以使用如下所示的排除篩選條件。 `*/folder-to-exclude-1`\$1`*/folder-to-exclude-2` 若要排除來源位置最上層的資料夾，您可以使用排除篩選條件，如下所示。 `/top-level-folder-to-exclude-1`\$1`/top-level-folder-to-exclude-2` **包含來源位置上的資料夾子集** 在某些情況下，您的來源位置可能是大型共用，而且您需要在根目錄下轉移一部分的資料夾。若要包含特定資料夾，請啟動任務執行並包含篩選條件如下。 `/folder-to-transfer/*` **排除特定檔案類型** 若要排除傳輸特定檔案類型，您可以建立任務執行並包含排除篩選條件，例如 `*.temp`。 **傳輸您指定的個別檔案** 若要傳輸個別檔案的清單，請使用包含篩選條件的 啟動任務執行，如下所示："`/folder/subfolder/file1.txt`\$1`/folder/subfolder/file2.txt`\$1`/folder/subfolder/file2.txt`" ## 建立包含篩選條件 包含篩選條件可定義您希望 DataSync 傳輸的檔案、物件和資料夾。您可以在建立、編輯或啟動任務時設定包含篩選條件。 DataSync 只會掃描和傳輸符合包含篩選條件的檔案和資料夾。例如，若要包含來源資料夾的子集，您可以指定 `/important_folder_1`\$1`/important_folder_2`。 **注意** 包含篩選條件僅支援萬用字元 (\$1) 字元做為模式中最右側的字元。例如，支援 `/documents*`\$1`/code*`，但`*.txt`不支援。 ### 使用 DataSync 主控台 1. 在 https：//[https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) 開啟 AWS DataSync 主控台。 1. 在左側導覽窗格中，選擇**任務**，然後選擇**建立任務**。 1. 設定任務的來源和目的地位置。 如需詳細資訊，請參閱[我可以將資料傳輸到哪裡 AWS DataSync？](working-with-locations.md) 1. 針對**要掃描的內容**，選擇**特定檔案、物件和資料夾**，然後選取**使用篩選條件**。 1. 對於**包含**，輸入您的篩選條件 （例如，`/important_folders`要包含重要目錄），然後選擇**新增模式**。 1. 視需要新增其他包含篩選條件。 ### 使用 AWS CLI 使用 時 AWS CLI，如果您有多個篩選條件，則必須在篩選條件周圍使用單引號 (`'`)，並使用 \$1 （管道） 做為分隔符號。 下列範例會在執行 `create-task`命令`/important_folder2`時指定兩個包含篩選條件 `/important_folder1`和 。 ``` aws datasync create-task --source-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \ --destination-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \ --includes FilterType=SIMPLE_PATTERN,Value='/important_folder1|/important_folder2' ``` ## 建立排除篩選條件 排除篩選條件會定義您不希望 DataSync 傳輸之來源位置中的檔案、物件和資料夾。您可以在建立、編輯或啟動任務時設定這些篩選條件。 **Topics** + [預設排除的資料](#directories-ignored-during-transfers) ### 預設排除的資料 DataSync 會自動排除某些資料傳輸： + `.snapshot` – DataSync 會忽略結尾為 的任何路徑`.snapshot`，通常用於儲存系統檔案或目錄的point-in-time快照。 + `/.aws-datasync` 和 `/.awssync` – DataSync 會在您的位置建立這些資料夾，以協助加速傳輸。 + `/.zfs` – 您可能會看到此資料夾搭配 Amazon FSx for OpenZFS 位置。 ### 使用 DataSync 主控台 1. 在 https：//[https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) 開啟 AWS DataSync 主控台。 1. 在左側導覽窗格中，選擇**任務**，然後選擇**建立任務**。 1. 設定任務的來源和目的地位置。 如需詳細資訊，請參閱[我可以將資料傳輸到哪裡 AWS DataSync？](working-with-locations.md) 1. 對於**排除**，輸入您的篩選條件 （例如`*/temp`，要排除暫時資料夾），然後選擇**新增模式**。 1. 視需要新增其他排除篩選條件。 1. 如有需要，請新增[包含篩選條件](#include-filters)。 ### 使用 AWS CLI 使用 時 AWS CLI，如果您有多個篩選條件，則必須在篩選條件周圍使用單引號 (`'`)，並使用 \$1 （管道） 做為分隔符號。 下列範例會在執行 `create-task`命令`*/tmp`時指定兩個排除篩選條件`*/temp`和 。 ``` aws datasync create-task \ --source-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \ --destination-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \ --excludes FilterType=SIMPLE_PATTERN,Value='*/temp|*/tmp' ``` # 了解 DataSync 如何處理檔案和物件中繼資料 AWS DataSync 可以在資料傳輸期間保留您的檔案或物件中繼資料。複製中繼資料的方式取決於您的傳輸位置，以及這些位置是否使用類似的中繼資料類型。 ## 系統層級中繼資料 一般而言，DataSync 不會複製系統層級中繼資料。例如，從 SMB 檔案伺服器傳輸時，您在檔案系統層級設定的許可不會複製到目的地儲存系統。 有例外狀況。在 Amazon S3 和其他物件儲存體之間傳輸時，DataSync 會複製一些[系統定義的物件中繼資料](#metadata-copied-between-object-s3)。 ## 在 Amazon S3 傳輸中複製的中繼資料 下表說明當傳輸涉及 Amazon S3 位置時DataSync 可以複製哪些中繼資料。 **Topics** + [至 Amazon S3](#metadata-copied-to-s3) + [Amazon S3 與其他物件儲存體之間](#metadata-copied-between-object-s3) + [Amazon S3 和 HDFS 之間](#metadata-copied-between-hdfs-s3) ### 至 Amazon S3 | 從其中一個位置複製時 | 前往此位置 | DataSync 可以複製 | | --- | --- | --- | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) | 下列為 Amazon S3 使用者中繼資料： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) 存放在 Amazon S3 使用者中繼資料中的檔案中繼資料可與使用 的檔案閘道上的 NFS 共用互通 AWS Storage Gateway。檔案閘道可讓您從內部部署網路存取由 DataSync 複製到 Amazon S3 的資料。此中繼資料也可以與 FSx for Lustre 互通。 當 DataSync 將包含此中繼資料的物件複製回 NFS 伺服器時，會還原檔案中繼資料。還原中繼資料需要將提升的許可授予 NFS 伺服器。如需詳細資訊，請參閱[使用 NFS 檔案伺服器設定 AWS DataSync 傳輸](create-nfs-location.md)。 | ### Amazon S3 與其他物件儲存體之間 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) ### Amazon S3 和 HDFS 之間 | 在這些位置之間複製時 | DataSync 可以複製 | | --- | --- | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) | 下列為 Amazon S3 使用者中繼資料：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html)HDFS 使用字串來存放檔案和資料夾使用者和群組擁有權，而不是數字識別符，例如 UIDs和 GIDs。 | ## 在 NFS 傳輸中複製的中繼資料 下表說明 DataSync 可以在使用網路檔案系統 (NFS) 的位置之間複製哪些中繼資料。 | 在這些位置之間複製時 | DataSync 可以複製 | | --- | --- | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) | ## 在 SMB 傳輸中複製的中繼資料 下表說明 DataSync 可以在使用伺服器訊息區塊 (SMB) 的位置之間複製哪些中繼資料。 | 在這些位置之間複製時 | DataSync 可以複製 | | --- | --- | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) | ## 在其他傳輸案例中複製的中繼資料 DataSync 會在這些儲存系統之間複製 （其中大部分具有不同的中繼資料結構） 時，以下列方式處理中繼資料。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) ## 了解 DataSync 何時以及如何套用預設 POSIX 中繼資料 DataSync 會在下列情況下套用預設 POSIX 中繼資料： + 當您傳輸的來源和目的地位置沒有類似的中繼資料結構時 + 當來源位置缺少中繼資料時 下表說明 DataSync 如何在這些類型的傳輸期間套用預設 POSIX 中繼資料： | 來源 | 目標 | 檔案許可 | 資料夾許可 | UID | GID | | --- | --- | --- | --- | --- | --- | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) | 0755 | 0755 | 65534 | 65534 | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) | 0644 | 0755 | 65534 | 65534 | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/metadata-copied.html) | 0644 | 0755 | 65534 | 65534 | 1 如果物件沒有之前由 DataSync 套用的中繼資料。 # 由 複製的連結和目錄 AWS DataSync AWS DataSync 會根據傳輸所涉及的儲存位置，以不同的方式處理硬連結、符號連結和目錄。 ## 硬性連結 以下是 DataSync 在一些常見傳輸案例中處理硬連結的方式： + **在 NFS 檔案伺服器、FSx for Lustre、FSx for OpenZFS、FSx for ONTAP （使用 NFS) 和 Amazon EFS 之間傳輸**時，會保留硬連結。 + **傳輸至 Amazon S3 時**，硬連結參考的每個基礎檔案只會傳輸一次。在增量傳輸期間，會在 S3 儲存貯體中建立個別的物件。如果硬連結在 Amazon S3 中保持不變，則在傳輸至 NFS 檔案伺服器、FSx for Lustre、FSx for OpenZFS、FSx for ONTAP （使用 NFS) 或 Amazon EFS 檔案系統時，會正確還原。 + **傳輸至 時Microsoft Azure Blob Storage**，硬連結參考的每個基礎檔案只會傳輸一次。在增量傳輸期間，如果來源中有新的參考，則會在 Blob 儲存體中建立個別的物件。從 傳輸時Azure Blob Storage，DataSync 會像傳輸個別檔案一樣傳輸硬連結。 + **在 SMB 檔案伺服器、FSx for Windows File Server 和 FSx for ONTAP （使用 SMB) 之間傳輸**時，不支援硬連結。如果 DataSync 在這些情況下遇到硬連結，則傳輸任務會完成並顯示錯誤。若要進一步了解，請檢查您的 CloudWatch 日誌。 + **轉移至 HDFS 時**，不支援硬連結。CloudWatch 日誌會將這些連結顯示為略過。 ## 符號連結 以下是 DataSync 在一些常見傳輸案例中處理符號連結的方式： + **在 NFS 檔案伺服器、FSx for Lustre、FSx for OpenZFS、FSx for ONTAP （使用 NFS) 和 Amazon EFS 之間傳輸**時，會保留符號連結。 + **轉移至 Amazon S3 時**，連結目標路徑會存放在 Amazon S3 物件中。在傳輸至 NFS 檔案伺服器、FSx for Lustre、FSx for OpenZFS、FSx for ONTAP 或 Amazon EFS 檔案系統時，連結會正確還原。 + **轉移至 時Azure Blob Storage**，不支援符號連結。CloudWatch 日誌會將這些連結顯示為略過。 + **在 SMB 檔案伺服器、FSx for Windows File Server 和 FSx for ONTAP （使用 SMB) 之間傳輸**時，不支援符號連結。DataSync 不會傳輸符號連結本身，而是傳輸符號連結參考的檔案。若要識別重複檔案並使用符號連結重複資料刪除，您必須在目的地檔案系統上設定重複資料刪除。 + **轉移至 HDFS 時**，不支援符號連結。CloudWatch 日誌會將這些連結顯示為略過。 ## 目錄 一般而言，DataSync 會在儲存系統之間傳輸時保留目錄。以下情況並非如此： + **轉移至 Amazon S3 時**，目錄會呈現為具有字首並以斜線 () 結尾的空白物件`/`。 + **Azure Blob Storage 在沒有階層命名空間的情況下轉移到 時**，目錄不存在。目錄看起來只是物件名稱的一部分。 # 設定如何處理檔案、物件和中繼資料 您可以設定 在位置之間傳輸時 AWS DataSync ， 如何處理您的檔案、物件及其相關聯的中繼資料。 例如，透過經常性傳輸，您可能想要使用來源的變更覆寫目的地中的檔案，以保持位置同步。您可以複製屬性，例如檔案和資料夾的 POSIX 許可、與物件相關聯的標籤，以及存取控制清單 ACLs)。 ## 傳輸模式選項 您可以設定 DataSync 是否在每次執行任務時，只傳輸初始複本後變更的資料 （包括中繼資料） 或所有資料。如果您打算定期轉移，您可能只想轉移自上次任務執行以來變更的內容。 | 主控台中的選項 | API 中的選項 | Description | | --- | --- | --- | | **僅傳輸已變更的資料** | [TransferMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) 設定為 `CHANGED` | 初始完全傳輸後，DataSync 只會複製來源和目的地位置之間不同的資料和中繼資料。 | | **傳輸所有資料** | [TransferMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) 設定為 `ALL` | DataSync 會將來源中的所有內容複製到目的地，而不比較位置之間的差異。 | ## 檔案和物件處理選項 您可以控制 DataSync 如何處理目的地位置中檔案或物件的一些層面。例如，DataSync 可以刪除目的地中不在來源中的檔案。 | 主控台中的選項 | API 中的選項 | Description | | --- | --- | --- | | **保留已刪除的檔案** | [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles) | 指定 DataSync 是否在來源中不存在的目的地位置維護檔案或物件。 如果您將任務設定為從 Amazon S3 儲存貯體刪除物件，則可能會針對特定儲存類別產生最短的儲存持續時間費用。如需詳細資訊，請參閱 [Amazon S3 傳輸的儲存類別考量](create-s3-location.md#using-storage-classes)。 您無法將任務設定為刪除目的地中的資料，也無法[傳輸所有資料](#task-option-transfer-mode)。當您傳輸所有資料時，DataSync 不會掃描目的地位置，也不知道要刪除的內容。 | | **覆寫檔案** | [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode) | 指定當來源資料或中繼資料變更時DataSync 是否修改目的地位置中的資料。如果您未將任務設定為覆寫資料，即使來源資料不同，也不會覆寫目的地資料。 如果您的任務覆寫物件，您可能會針對特定儲存類別產生額外費用 （例如，用於擷取或提早刪除）。如需詳細資訊，請參閱 [Amazon S3 傳輸的儲存類別考量](create-s3-location.md#using-storage-classes)。 | ## 中繼資料處理選項 DataSync 可以在傳輸期間保留檔案和物件中繼資料。DataSync 可以保留的中繼資料取決於涉及的儲存系統，以及這些系統是否使用類似的中繼資料結構。 在設定任務之前，請確定您了解 DataSync 在來源和目的地位置之間傳輸時如何處理[中繼資料](metadata-copied.md)和[特殊檔案](special-files-copied.md)。 **重要** DataSync 支援在 Google Cloud Storage 和 IBM Cloud Object Storage 等特定第三方雲端儲存系統中來回傳輸，這些儲存系統處理系統中繼資料的方式與 S3-compatible。對於這些傳輸，DataSync 會`CacheControl`盡力複製中繼資料屬性`ContentEncoding`，例如 `ContentType`、`ContentLanguage`、 和 。如果目的地儲存系統未套用這些屬性，則會在任務驗證期間忽略這些屬性。 | 主控台中的選項 | API 中的選項 | Description | | --- | --- | --- | | **複製擁有權** | [Gid](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Gid) 和 [Uid](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Uid) | 指定 DataSync 是否複製 POSIX 檔案和資料夾擁有權，例如檔案擁有者的群組 ID 和檔案擁有者的使用者 ID。 | | **複製許可** | [PosixPermissions](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PosixPermissions) | 指定 DataSync 是否將檔案和資料夾的 POSIX 許可從來源複製到目的地。 | | 複製時間戳記 | [Atime](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Atime) 和 [Mtime](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Mtime) | 指定 DataSync 是否將時間戳記中繼資料從來源複製到目的地。當您需要執行任務多次時為必要。 | | 複製物件標籤 | [ObjectTags](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-ObjectTags) | 指定在物件儲存系統之間傳輸時，DataSync 是否保留與物件相關聯的標籤。 | | 複製所有權、DACLs 和 SACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags) 設定為 OWNER\$1DACL\$1SACL | DataSync 會複製下列項目： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/configure-metadata.html) | | 複製所有權和 DACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags) 設定為 OWNER\$1DACL | DataSync 會複製下列項目： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/datasync/latest/userguide/configure-metadata.html) 當您選擇此選項時，DataSync 不會複製 SACLs。 | | 請勿複製所有權或 ACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags) 設定為 NONE | DataSync 不會複製任何所有權或許可資料。DataSync 寫入目的地位置的物件，是由提供憑證給 DataSync 以存取目的地的使用者所擁有。目的地物件許可是根據在目的地伺服器上設定的許可來決定。 | ## 設定檔案、物件和中繼資料處理選項 您可以設定 DataSync 在建立、編輯或啟動傳輸任務時如何處理檔案、物件和中繼資料。 ### 使用 DataSync 主控台 下列指示說明如何在建立任務時設定檔案、物件和中繼資料處理選項。 1. 在 https：//[https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) 開啟 AWS DataSync 主控台。 1. 在左側導覽窗格中，展開**資料傳輸**，然後選擇**任務**，然後選擇**建立任務**。 1. 設定任務的來源和目的地位置。 如需詳細資訊，請參閱[我可以將資料傳輸到哪裡 AWS DataSync？](working-with-locations.md) 1. 針對**傳輸模式**，選擇下列其中一個選項： + **僅傳輸已變更的資料** + **傳輸所有資料** 如需關於這些選項的詳細資訊，請參閱 [傳輸模式選項](#task-option-transfer-mode)。 1. 如果您希望 DataSync 在來源中不存在的目的地位置維護檔案或物件，請選取**保留已刪除的檔案**。 如果您未選擇此選項，且任務從 Amazon S3 儲存貯體刪除物件，則可能會針對特定儲存類別產生最短儲存持續時間費用。如需詳細資訊，請參閱 [Amazon S3 傳輸的儲存類別考量](create-s3-location.md#using-storage-classes)。 **警告** 您無法取消選取此選項，並啟用**傳輸所有資料**。當您傳輸所有資料時，DataSync 不會掃描目的地位置，也不知道要刪除什麼。 1. 如果您希望 DataSync 在來源資料或中繼資料變更時修改目的地位置中的資料，請選取**覆寫檔案**。 如果您的任務覆寫物件，您可能會針對特定儲存類別產生額外費用 （例如，用於擷取或提早刪除）。如需詳細資訊，請參閱 [Amazon S3 傳輸的儲存類別考量](create-s3-location.md#using-storage-classes)。 如果您未選擇此選項，即使來源資料不同，也不會覆寫目的地資料。 1. 在**傳輸選項**下，選取您希望 DataSync 如何處理中繼資料。如需選項的詳細資訊，請參閱 [中繼資料處理選項](#task-option-metadata-handling)。 **重要** 您在主控台中看到的選項取決於任務的來源和目的地位置。您可能需要展開**其他設定**，才能查看其中一些選項。 + **複製擁有權** + **複製許可** + **複製時間戳記** + **複製物件標籤** + **複製所有權、DACLs 和 SACLs** + **複製所有權和 DACLs** + **請勿複製所有權或 ACLs** ### 使用 DataSync API 您可以使用 `Options` 參數搭配下列任何操作來設定檔案、物件和中繼資料處理選項： + [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html) + [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html) + [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)