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

# 從 S3 儲存貯體自動匯入更新
<a name="autoimport-data-repo-dra"></a>

您可以設定 FSx for Lustre，在從 S3 儲存貯體新增、變更或刪除物件時自動更新檔案系統中的中繼資料。FSx for Lustre 會建立、更新或刪除對應於 S3 中變更的檔案和目錄清單。如果 S3 儲存貯體中變更的物件不再包含其中繼資料，FSx for Lustre 會維護檔案目前的中繼資料值，包括目前的許可。

**注意**  
FSx for Lustre 檔案系統和連結的 S3 儲存貯體必須位於相同的 中 AWS 區域 ，才能自動匯入更新。

您可以在建立資料儲存庫關聯時設定自動匯入，而且您可以隨時使用 FSx 管理主控台 AWS CLI、 或 AWS API 更新自動匯入設定。

**注意**  
您可以在相同的資料儲存庫關聯上設定自動匯入和自動匯出。本主題僅說明自動匯入功能。

**重要**  
如果在 S3 中修改物件並啟用所有自動匯入政策，且自動匯出已停用，則該物件的內容一律會匯入檔案系統中的對應檔案。如果檔案已存在於目標位置，則會覆寫檔案。
如果在檔案系統和 S3 中修改檔案，並啟用所有自動匯入和自動匯出政策，檔案系統中的檔案或 S3 中的物件可能會被另一個覆寫。不保證某個位置的稍後編輯會覆寫另一個位置的較早編輯。如果您在檔案系統和 S3 儲存貯體中修改相同的檔案，您應該確保應用程式層級協調，以防止此類衝突。FSx for Lustre 無法防止多個位置中的寫入衝突。

匯入政策指定您希望 FSx for Lustre 在連結 S3 儲存貯體的內容變更時如何更新檔案系統。資料儲存庫關聯可以有下列其中一個匯入政策：
+ **新增** – FSx for Lustre 只有在將新物件新增至連結的 S3 資料儲存庫時，才會自動更新檔案和目錄中繼資料。
+ **已變更** – 只有在變更資料儲存庫中的現有物件時，FSx for Lustre 才會自動更新檔案和目錄中繼資料。
+ **已刪除** – 只有在刪除資料儲存庫中的物件時，FSx for Lustre 才會自動更新檔案和目錄中繼資料。
+ **新增、變更和刪除的任意組合** – 當 S3 資料儲存庫中發生任何指定的動作時，FSx for Lustre 會自動更新檔案和目錄中繼資料。例如，您可以指定在物件新增至 (**新增**) 或從 S3 儲存庫移除 (**刪除**) 時更新檔案系統，但在物件變更時不會更新。
+ **未設定政策** – 從 S3 資料儲存庫新增、變更或刪除物件時，FSx for Lustre 不會更新檔案系統上的檔案和目錄中繼資料。如果您未設定匯入政策，則會針對資料儲存庫關聯停用自動匯入。您仍然可以使用匯入資料儲存庫任務手動匯入中繼資料變更，如中所述[使用資料儲存庫任務匯入變更](import-data-repo-task-dra.md)。

**重要**  
自動匯入不會同步下列 S3 動作與您連結的 FSx for Lustre 檔案系統：  
使用 S3 物件生命週期過期刪除物件
在已啟用版本控制的儲存貯體中永久刪除目前的物件版本
取消刪除已啟用版本控制之儲存貯體中的物件

對於大多數使用案例，我們建議您設定**新增**、**變更**和**刪除**的匯入政策。此政策可確保在連結的 S3 資料儲存庫中所做的所有更新都會自動匯入您的檔案系統。

當您設定匯入政策，根據連結的 S3 資料儲存庫中的變更來更新檔案系統檔案和目錄中繼資料時，FSx for Lustre 會在連結的 S3 儲存貯體上建立事件通知組態。事件通知組態名為 `FSx`。請勿修改或刪除 S3 儲存貯體上的`FSx`事件通知組態 – 這樣做可防止更新的檔案和目錄中繼資料自動匯入至您的檔案系統。

當 FSx for Lustre 更新在連結的 S3 資料儲存庫上變更的檔案清單時，即使檔案已寫入鎖定，也會以更新版本覆寫本機檔案。

FSx for Lustre 會盡最大努力更新您的檔案系統。FSx for Lustre 無法在下列情況更新檔案系統：
+ 如果 FSx for Lustre 沒有開啟已變更或新 S3 物件的許可。在此情況下，FSx for Lustre 會略過物件並繼續。DRA 生命週期狀態不受影響。
+ 如果 FSx for Lustre 沒有儲存貯體層級許可，例如 for `GetBucketAcl`。這會導致資料儲存庫生命週期狀態變成**設定錯誤**。如需詳細資訊，請參閱[資料儲存庫關聯生命週期狀態](dra-lifecycles.md)。
+ 如果已刪除或變更連結 S3 儲存貯體上的`FSx`事件通知組態。這會導致資料儲存庫生命週期狀態變成**設定錯誤**。如需詳細資訊，請參閱[資料儲存庫關聯生命週期狀態](dra-lifecycles.md)。

我們建議您[開啟](cw-event-logging.md#manage-logging) CloudWatch Logs 的記錄功能，以記錄無法自動匯入的任何檔案或目錄的相關資訊。日誌中的警告和錯誤包含失敗原因的相關資訊。如需詳細資訊，請參閱[資料儲存庫事件日誌](data-repo-event-logs.md)。

## 先決條件
<a name="auto-import-prereqs-dra"></a>

FSx for Lustre 需要下列條件，才能從連結的 S3 儲存貯體自動匯入新的、已變更或刪除的檔案：
+ 檔案系統及其連結的 S3 儲存貯體位於相同的 中 AWS 區域。
+ S3 儲存貯體沒有設定錯誤的**生命週期狀態**。如需詳細資訊，請參閱[資料儲存庫關聯生命週期狀態](dra-lifecycles.md)。
+ 您的帳戶具有在連結的 S3 儲存貯體上設定和接收事件通知所需的許可。

## 支援的檔案變更類型
<a name="file-change-support-dra"></a>

FSx for Lustre 支援將下列變更匯入至連結 S3 儲存貯體中發生的檔案和目錄：
+ 檔案內容的變更。
+ 檔案或目錄中繼資料的變更。
+ 符號連結目標或中繼資料的變更。
+ 刪除檔案和目錄。如果您在連結的 S3 儲存貯體中刪除對應至檔案系統中目錄的物件 （也就是金鑰名稱結尾為斜線的物件），則 FSx for Lustre 只會在檔案系統上刪除對應的目錄。

## 更新匯入設定
<a name="manage-autoimport-dra"></a>

您可以在建立資料儲存庫關聯時，為連結的 S3 儲存貯體設定檔案系統的匯入設定。如需詳細資訊，請參閱[建立 S3 儲存貯體的連結](create-linked-dra.md)。

您也可以隨時更新匯入設定，包括匯入政策。如需詳細資訊，請參閱[更新資料儲存庫關聯設定](update-dra-settings.md)。

## 監控自動匯入
<a name="monitoring-autoimport"></a>

如果 S3 儲存貯體中的變更率超過自動匯入可以處理這些變更的速率，則會延遲匯入 FSx for Lustre 檔案系統的對應中繼資料變更。如果發生這種情況，您可以使用 `AgeOfOldestQueuedMessage` 指標來監控等待自動匯入處理的最舊變更的存留期。如需此指標的詳細資訊，請參閱 [FSx for Lustre S3 儲存庫指標](fs-metrics.md#auto-import-export-metrics)。

如果匯入中繼資料變更的延遲超過 14 天 （使用 `AgeOfOldestQueuedMessage` 指標測量），則尚未由自動匯入處理之 S3 儲存貯體的變更不會匯入檔案系統。此外，您的資料儲存庫關聯生命週期會標示為 **MISCONFIGURED**，並停止自動匯入。如果您已啟用自動匯出，則自動匯出會繼續監控 FSx for Lustre 檔案系統是否有變更。不過，其他變更不會從 FSx for Lustre 檔案系統同步到 S3。

若要將資料儲存庫關聯從 **MISCONFIGURED** 生命週期狀態傳回**可用**生命週期狀態，您必須更新資料儲存庫關聯。您可以使用 [update-data-repository-association](https://docs.aws.amazon.com/cli/latest/reference/fsx/update-data-repository-association.html) CLI 命令 （或對應的 [UpdateDataRepositoryAssociation](https://docs.aws.amazon.com/fsx/latest/APIReference/API_UpdateDataRepositoryAssociation.html) API 操作） 更新資料儲存庫關聯。您需要的唯一請求參數是您要更新`AssociationID`的資料儲存庫關聯的 。

在資料儲存庫關聯生命週期狀態變更為**可用**後，自動匯入 （以及啟用時自動匯出） 會重新啟動。重新啟動時，自動匯出會繼續同步檔案系統變更為 S3。若要將 S3 中新物件和已變更物件的中繼資料與未匯入或資料儲存庫關聯處於設定錯誤狀態時的 FSx for Lustre 檔案系統同步，請執行[匯入資料儲存庫任務](import-data-repo-task-dra.md)。匯入資料儲存庫任務不會將 S3 儲存貯體中的刪除與 FSx for Lustre 檔案系統同步。如果您想要將 S3 與檔案系統完全同步 （包括刪除），則必須重新建立檔案系統。

為了確保匯入中繼資料變更的延遲不超過 14 天，我們建議您在`AgeOfOldestQueuedMessage`指標上設定警示，並在指標超過警示閾值時減少 S3 `AgeOfOldestQueuedMessage` 儲存貯體中的活動。對於連接到具有單一碎片的 S3 儲存貯體的 FSx for Lustre 檔案系統，持續從 S3 傳送最大數量的可能變更，且僅在 FSx for Lustre 檔案系統上執行自動匯入，自動匯入可以在 14 天內處理 7 小時的 S3 變更待處理項目。

此外，透過單一 S3 動作，您可以產生比自動匯入在 14 天內處理更多變更。這些動作類型的範例包括但不限於 AWS Snowball 上傳至 S3 和大規模刪除。如果您大規模變更要與 FSx for Lustre 檔案系統同步的 S3 儲存貯體，為了防止自動匯入變更超過 14 天，您應該刪除檔案系統，並在 S3 變更完成後重新建立。

如果您的`AgeOfOldestQueuedMessage`指標正在增長，請檢閱您的 S3 儲存貯體 `GetRequests`、`PostRequests`、 `PutRequests`和 `DeleteRequests` 指標是否有活動變更，這會導致傳送到自動匯入的速率和/或變更數量增加。如需可用 S3 指標的相關資訊，請參閱[《Amazon S3 使用者指南》中的監控](https://docs.aws.amazon.com/AmazonS3/latest/userguide/monitoring-overview.html) *Amazon S3*。

如需所有可用 FSx for Lustre 指標的清單，請參閱 [使用 Amazon CloudWatch 監控](monitoring-cloudwatch.md)。