本快速入門導覽課程說明如何使用 Spanner 免費試用執行個體和範例應用程式。詳情請參閱「Spanner 免費試用執行個體總覽」。
開始使用免付費試用執行個體
只要擁有 Google 帳戶，且專案已啟用 Cloud Billing，即可建立 Spanner 90 天免費試用執行個體。除非您選擇將免費試用執行個體升級為付費執行個體，否則不會產生任何費用。
您可以使用 Google Cloud 控制台或 Google Cloud CLI 建立免費試用執行個體。
事前準備
Google Cloud 控制台
前往 Google Cloud 控制台的「Spanner」頁面。
選取或建立 Google Cloud 專案 (如果尚未建立)。
如果專案已啟用 Cloud Billing，請前往下一節「建立免費試用執行個體」。
如果專案未啟用 Cloud Billing，請連結現有 Cloud Billing 帳戶，或建立新的 Cloud Billing 帳戶。Google 會使用這項付款資訊驗證您的身分。除非您明確將 Cloud Billing 帳戶升級為付費帳戶，並將 Spanner 免費試用執行個體升級為付費執行個體，否則我們不會向您收取 Spanner 執行個體的費用。
a. 按一下「前往帳單」。
b. 然後按一下「連結帳單帳戶」。
c. 按照步驟建立帳單帳戶，然後連結至專案。
d. 為專案啟用 Cloud Billing 後，請前往「Spanner」頁面。
e. 按一下「Create free instance」(建立免費執行個體)，然後前往下一節的「建立免費試用執行個體」。
選用：如果您先前已在專案中建立 Spanner 執行個體，系統會顯示下列「Spanner 執行個體」頁面。
按一下「建立免費執行個體」。
gcloud
- 登入 Google Cloud 帳戶。如果您是 Google Cloud新手，歡迎 建立帳戶，親自體驗產品的實際應用成效。新客戶還能獲得價值 $300 美元的免費抵免額，能用於執行、測試及部署工作負載。
-
安裝 Google Cloud CLI。
-
若您採用的是外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。
-
執行下列指令，初始化 gcloud CLI：
gcloud init -
選取或建立專案所需的角色
- 選取專案：選取專案時，不需要具備特定 IAM 角色，只要您在專案中獲派角色，即可選取該專案。
-
建立專案：如要建立專案，您必須具備專案建立者角色 (
roles/resourcemanager.projectCreator)，其中包含resourcemanager.projects.create權限。瞭解如何授予角色。
-
建立 Google Cloud 專案：
gcloud projects create PROJECT_ID
將
PROJECT_ID替換為要建立的專案名稱。 Google Cloud -
選取您建立的 Google Cloud 專案：
gcloud config set project PROJECT_ID
將
PROJECT_ID替換為 Google Cloud 專案名稱。
-
如果您使用的是本機殼層，請為使用者帳戶建立本機驗證憑證：
gcloud auth application-default login
如果您使用 Cloud Shell，則不需要執行這項操作。
如果系統傳回驗證錯誤，且您使用外部識別資訊提供者 (IdP)，請確認您已 使用聯合身分登入 gcloud CLI。
-
安裝 Google Cloud CLI。
-
若您採用的是外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。
-
執行下列指令，初始化 gcloud CLI：
gcloud init -
選取或建立專案所需的角色
- 選取專案：選取專案時，不需要具備特定 IAM 角色，只要您在專案中獲派角色，即可選取該專案。
-
建立專案：如要建立專案，您必須具備專案建立者角色 (
roles/resourcemanager.projectCreator)，其中包含resourcemanager.projects.create權限。瞭解如何授予角色。
-
建立 Google Cloud 專案：
gcloud projects create PROJECT_ID
將
PROJECT_ID替換為要建立的專案名稱。 Google Cloud -
選取您建立的 Google Cloud 專案：
gcloud config set project PROJECT_ID
將
PROJECT_ID替換為 Google Cloud 專案名稱。
-
如果您使用的是本機殼層，請為使用者帳戶建立本機驗證憑證：
gcloud auth application-default login
如果您使用 Cloud Shell，則不需要執行這項操作。
如果系統傳回驗證錯誤，且您使用外部識別資訊提供者 (IdP)，請確認您已 使用聯合身分登入 gcloud CLI。
建立免費試用執行個體
Google Cloud 控制台
下列步驟說明如何使用Google Cloud 控制台建立免費試用執行個體。
在「建立免費試用的執行個體」頁面上，執行下列操作：
- 輸入要顯示在 Google Cloud 控制台的執行個體名稱。執行個體在 Google Cloud 專案中不得重複。
- 輸入執行個體 ID，永久識別執行個體。執行個體 ID 在 Google Cloud 專案中也不得重複。執行個體 ID 設定後即無法變更。
從「Region」(區域) 下拉式選單中選取設定位置。
執行個體設定會決定執行個體的儲存和複製地理位置。您可以在任何 Spanner 區域執行個體設定中建立免費試用執行個體。如需所有可用執行個體設定的完整清單，請參閱「單區域、雙區域和多區域設定」。
按一下「建立免費執行個體」。
建立免費試用執行個體後，Spanner 會建立範例資料庫，供您探索及熟悉 Spanner 功能。詳情請參閱「免費試用執行個體總覽」。
gcloud
如要建立免費試用執行個體，請使用 gcloud spanner instances create 指令。
gcloud spanner instances create INSTANCE_ID \
--instance-type=free-instance --config=INSTANCE_CONFIG \
--description=INSTANCE_DESCRIPTION
更改下列內容：
- INSTANCE_ID： Google Cloud 專案中的永久專屬 ID。執行個體 ID 設定後即無法變更。
INSTANCE_CONFIG：執行個體設定的永久 ID，定義執行個體的地理位置。您可以在任何 Spanner 區域執行個體設定中建立免費試用執行個體：
INSTANCE_DESCRIPTION：執行個體在Google Cloud 控制台中的顯示名稱。執行個體名稱在Google Cloud 專案中不得重複。
舉例來說，如要使用區域執行個體設定 regional-us-east5 建立名為 trial-instance 的免費試用執行個體，並將顯示名稱設為 Trial Instance，請執行下列指令：
gcloud spanner instances create trial-instance --config=regional-us-east5 \
--instance-type=free-instance --description="Trial Instance"
建立免費試用執行個體後，系統會提示您啟動逐步教學課程，繼續學習及探索 Spanner，瞭解如何使用範例應用程式建立資料庫。詳情請參閱「開始使用範例應用程式」。
開始使用範例資料庫
使用 Google Cloud 控制台建立免費試用執行個體後，Spanner 會建立範例資料庫，供您探索及熟悉 Spanner 功能。
您可以使用 Google Cloud 控制台存取範例資料庫。
Google Cloud 控制台
前往 Google Cloud 控制台的「Spanner Instances」(Spanner 執行個體) 頁面。
按一下免費試用執行個體的名稱。
按一下範例資料庫的名稱。
您可以查看範例資料庫中的資料表和資料。您也可以在 Spanner Studio 頁面存取及查看已儲存的查詢。已儲存的查詢會展示不同的 Spanner 功能。
開始使用範例應用程式
Spanner 也提供開放原始碼的範例應用程式，協助您開始使用 Spanner 免費試用執行個體。這個範例應用程式包含由 Spanner 資料庫支援的後端 gRPC 服務，以及將流量導向該服務的工作負載產生器。
您可以使用 Google Cloud CLI 存取範例應用程式。
gcloud
完成「gcloud 設定」一文所述步驟，包括建立及設定預設 Google Cloud 專案、啟用 Cloud Spanner API，以及設定 OAuth 2.0 以取得驗證憑證，進而使用 Cloud Spanner API。
執行
gcloud auth application-default login指令，使用驗證憑證設定本機開發環境。執行
gcloud spanner samples run指令，下載範例應用程式，並啟動後端 gRPC 服務和指定範例應用程式的工作負載產生器：gcloud spanner samples run APPNAME --instance-id INSTANCE_ID如要進一步瞭解範例應用程式的其他可用指令，請參閱 gcloud CLI 說明文件。
匯入您的資料
您可以使用 CSV 檔案、MySQL dump 檔案或 PostgreSQL dump 檔案，將自己的資料匯入 Spanner 資料庫。您可以透過 Cloud Storage 上傳本機檔案，或直接從 Cloud Storage bucket 上傳。使用 Cloud Storage 上傳本機檔案可能會產生費用。
如果選擇使用 CSV 檔案，您也必須上傳含有資料庫結構定義的獨立 JSON 檔案。
Google Cloud 控制台
前往 Google Cloud 控制台的「Spanner Instances」(Spanner 執行個體) 頁面。
選取要建立資料庫的執行個體。
按一下「匯入我的資料」。
輸入下列值：
選取「檔案類型」。
從電腦上傳檔案，或選取檔案的 Cloud Storage bucket 路徑。
(選用) 如果選擇使用 CSV 檔案，您也需要上傳包含資料庫結構定義的 JSON 檔案。JSON 檔案必須使用下列結構定義結構定義：
{ "name": "COLUMN_NAME", "type": "TYPE", "notNull": NOT_NULL_VALUE, "primaryKeyOrder": PRIMARY_KEY_ORDER }
更改下列內容：
COLUMN_NAME：資料表中的資料欄名稱。
TYPE：資料欄的資料類型。
(選用) NOT_NULL_VALUE：資料欄是否可儲存空值。有效輸入值為
true或false。 預設為false。(選用)：PRIMARY_KEY_ORDER：決定主鍵順序。為非主鍵欄設定
0值。將值設為整數，例如主鍵欄的1。編號較小的資料欄會先出現在複合主鍵中。
CSV 檔案預設會以半形逗號做為欄位分隔符號，並以換行符號做為行分隔符號。如要進一步瞭解如何使用自訂分隔符，請參閱
gcloud alpha spanner databases import參考資料。選取新的或現有資料庫做為目的地。
按一下「匯入」。
Spanner 會開啟 Cloud Shell，並填入安裝 Spanner 遷移工具的指令，然後執行
gcloud alpha spanner databases import指令。按下ENTER鍵，將資料匯入資料庫。
升級免費試用執行個體
以下步驟說明如何升級免費試用例項。
Google Cloud 控制台
前往 Google Cloud 控制台的「Spanner Instances」(Spanner 執行個體) 頁面。
按一下免費試用執行個體的名稱。
在「執行個體總覽」頁面，點選「編輯執行個體」或「編輯以升級」。
在「Update instance name」(更新執行個體名稱) 欄位中，輸入更適合付費執行個體的名稱 (如適用)。
選取「升級選項」。您可以選取下列任一選項：
- 立即升級
- 在試用期結束後，自動升級至 Enterprise 版的完整版本
- 稍後提醒我
「Summary」(摘要) 區段會說明所選升級付費執行個體的運算和儲存費用。
按一下「儲存」即可升級免費試用執行個體。
gcloud
如要將免費試用執行個體升級為付費 Enterprise 版執行個體，並保留相同的執行個體設定，請執行下列 gcloud spanner instances update 指令：
gcloud spanner instances update INSTANCE_ID --instance-type=provisioned
刪除執行個體
Google Cloud 控制台
前往 Google Cloud 控制台的「Spanner Instances」(Spanner 執行個體) 頁面。
按一下您要刪除的執行個體名稱。
在「執行個體總覽」頁面，點選「刪除執行個體」。
請按照操作說明來確認您要刪除的執行個體。
點選「刪除」。
gcloud
如要刪除免付費試用執行個體，請使用下列
gcloud spanner instances delete
指令：
gcloud spanner instances delete INSTANCE_ID
後續步驟
- 進一步瞭解 Spanner 免費試用執行個體。
- 進一步瞭解 Spanner 執行個體和資料庫。
- 如要瞭解免費試用期結束後的 Spanner 定價，請參閱定價頁面。