設定環境

本頁面將逐步說明使用 Google Cloud CLI、用戶端程式庫和 Spanner 驅動程式，透過 Cloud Spanner API 進行設定的必要步驟。

如要透過 Google Cloud 控制台使用 Spanner，請參閱「快速入門導覽課程：使用控制台」。

必要的角色

如要取得使用 Spanner 資料庫及與其互動所需的權限，請要求管理員授予下列 IAM 角色：

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

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

設定 Google Cloud 專案

  1. 前往 Google Cloud 控制台的「Projects」(專案) 頁面。

    前往「Projects」(專案) 頁面

  2. 建立新 Google Cloud 專案，或按一下專案名稱開啟現有專案。

  3. 開啟終端機視窗，並將專案設為 Google Cloud CLI 的預設專案，然後將 MY_PROJECT_ID 換成專案 ID (而非專案名稱)：

    gcloud config set project MY_PROJECT_ID

  4. 確認 Google Cloud 專案已啟用計費功能。

    5. 您也可以瞭解 Spanner 定價。

  5. 為專案啟用 Cloud Spanner API。

    啟用 Cloud Spanner API

    注意：如果您使用其他專案中的服務帳戶存取 Spanner 執行個體，則必須在兩個專案中都啟用 Spanner API。

設定驗證方法

選取您打算存取 API 的方式所對應的分頁：

控制台

使用 Google Cloud 控制台存取 Google Cloud 服務和 API 時，不需要設定驗證。

gcloud

安裝 Google Cloud CLI。 完成後，執行下列指令來初始化 Google Cloud CLI：

gcloud init

如果您使用外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。

如要設定 gcloud CLI，使用服務帳戶模擬功能向 Google API 進行驗證，而非使用使用者憑證，請執行下列指令：

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

詳情請參閱「服務帳戶模擬」。

Terraform

如要在本機開發環境中使用 Terraform 程式碼，請安裝並初始化 gcloud CLI，然後使用使用者憑證設定應用程式預設憑證。

  1. 安裝 Google Cloud CLI。

  2. 如果您使用外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。

  3. 如果您使用本機殼層，請為使用者帳戶建立本機驗證憑證： 

    gcloud auth application-default login

    如果您使用的是 Cloud Shell，則不必執行這項操作。

    如果系統傳回驗證錯誤，且您使用外部識別資訊提供者 (IdP)，請確認您已 使用聯合身分登入 gcloud CLI。

詳情請參閱「 設定本機開發環境的驗證機制」。

用戶端程式庫

如要在本機開發環境中使用用戶端程式庫，請安裝並初始化 gcloud CLI，然後使用使用者憑證設定應用程式預設憑證。

  1. 安裝 Google Cloud CLI。

  2. 如果您使用外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。

  3. 如果您使用本機殼層，請為使用者帳戶建立本機驗證憑證： 

    gcloud auth application-default login

    如果您使用 Cloud Shell，則不需要執行這項操作。

    如果系統傳回驗證錯誤，且您使用的是外部識別資訊提供者 (IdP)，請確認您已 使用聯合身分登入 gcloud CLI。

詳情請參閱「 設定本機開發環境的驗證機制」。

如要設定本機 ADC 檔案，使用服務帳戶模擬功能向 Google API 進行驗證，而非使用使用者憑證，請執行下列指令：

gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

詳情請參閱「服務帳戶模擬」。

REST

如要在本機開發環境中使用 REST API，請使用提供給 gcloud CLI 的憑證。

    安裝 Google Cloud CLI。

    如果您使用外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。

詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」。

您可以使用服務帳戶模擬功能，為 REST API 要求產生存取權杖。 詳情請參閱「模擬服務帳戶」。

執行 Google Cloud CLI

開發環境和驗證設定完成後，請執行 gcloud 指令列工具，與 Spanner 互動：

gcloud spanner instance-configs list

您應該會看到專案可存取的 Spanner 執行個體設定清單，包括單一區域、雙區域和多區域設定。詳情請參閱「執行個體總覽」。

您已完成設定！

後續步驟

瞭解如何使用 Cloud 用戶端程式庫和驅動程式，建立 Spanner 執行個體、資料庫、資料表和索引。接著在 Spanner 中儲存、查詢及讀取資料。