使用 gcloud 工具上傳和管理索引

您可以使用 Google Cloud CLI 在本機測試應用程式，以及管理實際運作的 Firestore (Datastore 模式) 執行個體的索引。本頁面說明這類活動的一般工作流程。

注意： 本文假設您已為專案啟用 Datastore API；下載包含 gcloud CLI 的 Google Cloud CLI；並使用 gcloud init 設定 gcloud CLI。

gcloud CLI 支援以下工作流程：

1. 建立 Datastore 執行個體本機支援作業，包括目錄、必要文件以及專案 ID。
2. 啟動 Datastore 模擬器 (此模擬器能在本機模擬實際運作的 Datastore 環境)。
3. 透過應用程式的模擬器查詢產生索引定義。
4. 將手動建立或產生的索引定義上傳至實際運作的資料庫執行個體。
5. 刪除實際運作的資料庫執行個體中未使用的索引。

使用指令列工具的開發工作流程

以下是使用 gcloud CLI 的一般工作流程：

1. 啟動 Datastore 模擬器。

2. 設定環境變數，讓應用程式知道正在使用模擬器。

3. 啟動應用程式並以模擬器進行測試。您需執行應用程式對查詢模擬器使用的查詢，才能為實際工作環境資料庫的執行個體產生索引。

4. 使用 indexes create 指令上傳產生的索引，並傳遞本機 index.yaml 檔案的路徑，如下列範例所示：

   gcloud datastore indexes create ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml
   

   路徑範例假設您沒有為 data-dir 選項設定特定的目錄。如果您已設定專用目錄，請將路徑修改為 index.yaml 檔案的路徑。

5. 移除環境變數，讓應用程式知道正在使用實際運作的資料庫執行個體。

6. 使用實際運作的資料庫執行個體執行應用程式。

7. 在將來，您可能不會再使用其中的部分索引。您可以從實際工作環境資料庫的執行個體中刪除未使用的索引，方法是先將這些索引自本機 index.yaml 檔案中刪除，再叫用 indexes cleanup 指令：

   gcloud datastore indexes cleanup ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml
   

   如果您已為 data-dir 選項設定專用目錄，請修改範例中的路徑，改為 index.yaml 檔案的路徑。

後續步驟

• 進一步瞭解模擬器。
• 深入瞭解索引設定。