為 Looker (Google Cloud Core) 執行個體建立排定匯出時間的工作

本頁面說明如何為 Looker (Google Cloud Core) 執行個體設定排定時間的匯出工作。排定的匯出作業每 24 小時會執行一次，開始時間由您設定。匯出內容會儲存至 Cloud Storage bucket。排定匯出作業不會造成 Looker (Google Cloud Core) 執行個體停機。

排定匯出作業時，系統會匯出執行個體中的所有資料、設定和內容，但下列項目除外：

• 不會匯出 BigQuery 資料。

• 不會匯出 Secret Manager 資料。

• 系統不會匯出 Looker Studio 報表。

• 任何 Google Cloud 控制台設定 (必須在每個執行個體的控制台中進行) 都不會匯出。 Google Cloud 不過，Looker (Google Cloud Core) 應用程式中 Looker 管理面板的設定會匯出。

• 系統不會匯出執行個體中儲存的任何 OAuth 權杖。如果 OAuth 用於個別資料庫連線，匯入後，每個使用者都必須重新登入，並更新使用 OAuth 的資料庫連線權杖。

• Looker 應用程式 API 金鑰不會匯出。由於 API 金鑰不會匯入套件，所有使用者都將無法存取現有的 API 金鑰。

• 如果匯出後匯入的 Looker (Google Cloud Core) 執行個體，與建立匯出內容的執行個體使用不同的網路設定，您可能需要以不同方式設定與外部服務的連線。

• 如果從某個 Google Cloud 專案的執行個體匯出的內容移至其他專案的執行個體，則必須在新專案中設定 IAM 權限，讓使用者存取該執行個體。

排定的匯出程序需要幾分鐘至幾小時才能完成，實際時間取決於執行個體的大小。排定的匯出程序執行期間，無法進行匯入作業和一次性匯出作業。

排定匯出工作後，您就可以設定指令碼，每天將匯出的資料匯入備份執行個體。

必要角色

如要取得建立 Looker (Google Cloud Core) 預定匯出作業所需的權限，請要求管理員在建立執行個體的專案中，授予您下列 IAM 角色：

• 所有項目： Looker 管理員 (roles/looker.admin)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

事前準備

1. 建立 Cloud Storage bucket，用來儲存匯出構件。
2. 在 Cloud Key Management Service 中建立客戶管理加密金鑰 (CMEK)。即使執行個體未使用 CMEK，也必須提供這項資訊，才能加密排定匯出作業的資料。CMEK 金鑰必須與 Looker (Google Cloud Core) 執行個體位於不同區域，或是全域金鑰。
3. 找出 Looker (Google Cloud Core) 執行個體的服務帳戶。
4. 將下列必要的 Identity and Access Management (IAM) 角色和權限授予執行個體的服務帳戶：
   • 在儲存匯出內容的 Cloud Storage bucket 上，授予 roles/storage.objectAdmin 角色。
   • 在用於加密資料的 CMEK 金鑰上授予roles/cloudkms.cryptoKeyEncrypterDecrypter 角色 。
   • 或者，您也可以建立具備下列權限的自訂角色：
     • storage.objects.create
     • storage.objects.delete
     • cloudkms.cryptoKeyVersions.useToEncrypt
     • cloudkms.cryptoKeyVersions.useToDecrypt

設定排定匯出工作

您可以使用 Google Cloud 控制台或 gcloud 設定排定時間的匯出工作。

主控台

1. 前往 Google Cloud 控制台的 Looker (Google Cloud Core)「Instances」(執行個體) 頁面。

   前往 Looker 執行個體

2. 按一下要排定匯出作業的執行個體名稱。

3. 按一下「匯出」分頁標籤。

4. 展開「排定匯出工作」專區，然後輸入下列資訊：

   1. 開始時間：以當地時間 (HH:MM) 執行每日匯出的時段。
   2. Cloud Storage 值區：Cloud Storage 值區的 URI，例如：gs://bucket-name/export-path。
   3. Cloud KMS 金鑰：選取用於加密執行個體資料的 Cloud Key Management Service 金鑰。

5. 按一下「排定時間」。

gcloud

1. 如要設定定期匯出，請執行下列 gcloud 指令：

gcloud looker instances update INSTANCE_NAME \
    --project=PROJECT_ID \
    --region=REGION \
    --periodic-export-gcs-uri="gs://BUCKET_NAME/EXPORT_PATH" \
    --periodic-export-kms-key="KMS_KEY_NAME" \
    --periodic-export-start-time="TIME"

更改下列內容：

• INSTANCE_NAME：Looker (Google Cloud Core) 執行個體的名稱。
• PROJECT_ID：您的 Google Cloud 專案 ID。
• REGION：執行個體所在的區域。
• BUCKET_NAME：Cloud Storage 值區的名稱。
• EXPORT_PATH：bucket 內匯出構件的路徑。
• KMS_KEY_NAME：CMEK 金鑰的完整資源名稱。
• TIME：以世界標準時間 (HH:MM) 格式表示每日匯出作業的執行時間。

驗證匯出設定

設定時間表後，您可以在「執行個體詳細資料」頁面中查看排定的匯出工作設定。

1. 前往 Google Cloud 控制台的 Looker (Google Cloud Core)「Instances」(執行個體) 頁面。

   前往 Looker 執行個體

2. 按一下執行個體的名稱。

3. 在「執行個體詳細資料」頁面中，查看「匯出時間表」設定，包括每天的預定開始時間 (以當地時間為準)。開始時間會提供執行個體「匯出」頁面的連結。

停止定期匯出作業

如要停止定期匯出作業，請清除設定欄位。

主控台

1. 前往 Google Cloud 控制台的「Instances」(執行個體) 頁面。

   前往 Looker 執行個體

2. 按一下執行個體的名稱。

3. 按一下「匯出」分頁標籤。

4. 在「設定定期匯出排程」部分，清除「Cloud Storage 值區」、「客戶管理的加密金鑰」和「時間」欄位的值。

5. 按一下「清除時間表」。

gcloud

1. 如要停止定期匯出作業，請執行下列 gcloud 指令：

gcloud looker instances update INSTANCE_NAME \
    --project=PROJECT_ID \
    --region=REGION \
    --clear-periodic-export-config

更改下列內容：

• INSTANCE_NAME：Looker (Google Cloud Core) 執行個體的名稱。
• PROJECT_ID：您的 Google Cloud 專案 ID。
• REGION：執行個體所在的區域。

後續步驟

• 瞭解如何從 Cloud Storage 匯入 Looker (Google Cloud Core) 執行個體資料。
• 排解匯出或匯入錯誤。