使用 Spanner Omni CLI 的快速入門導覽課程

本文說明如何使用 Spanner Omni 指令列介面 (CLI) 與 Spanner Omni 部署作業互動及管理。Spanner Omni CLI 提供常見管理工作的指令，並包含用於查詢資料庫的互動式 SQL Shell。

事前準備

使用 Spanner Omni CLI 前，請先確認符合下列規定：

  1. 已設定並執行 Spanner Omni 部署作業。
  2. 執行 Spanner Omni CLI 的機器可透過網路存取 Spanner Omni 部署作業的負載平衡器，或部署作業中的至少一個伺服器。

步驟 1：下載並安裝 Spanner Omni CLI

  1. 從 spanner-omni Cloud Storage bucket 下載 Spanner Omni CLI。

    前往 Spanner Omni 值區

  2. 解壓縮 tar 檔案。

    tar -xvf CLI_TAR_FILE

    這會在 google/spanner/bin 目錄中安裝名為 spanner 的 Spanner Omni CLI 二進位檔。

    如要執行 spanner 指令，請將 google/spanner/bin 目錄新增至 PATH 環境變數，或在下列步驟中使用二進位檔的完整路徑。

步驟 2：連線至部署作業

根據預設，Spanner Omni CLI 會嘗試連線至 localhost:15000。如要連線至特定部署作業，請使用 --deployment-endpoint 標記。

舉例來說，下列指令會列出部署作業中的區域：

spanner deployment zones list \
    --deployment-endpoint=LOAD_BALANCER_IP_OR_SERVER_IP:PORT

步驟 3：執行常見指令

以下是您可以使用 Spanner Omni CLI 執行的常見管理指令。

取得說明

如要查看可用指令和通用標記清單，請執行：

spanner --help

建立資料庫

如要在部署作業中建立新資料庫，請執行：

spanner databases create DATABASE_NAME \
    --deployment-endpoint=LOAD_BALANCER_IP_OR_SERVER_IP:PORT

列出所有資料庫

如要列出部署作業中的所有資料庫，請執行下列指令：

spanner databases list \
    --deployment-endpoint=LOAD_BALANCER_IP_OR_SERVER_IP:PORT

步驟 4：啟動互動式 SQL 殼層工作階段

Spanner Omni CLI 包含互動式 SQL 殼層，可執行查詢。使用 --database 標記啟動特定資料庫的殼層後，您就能執行 SQL 指令，不必為每個查詢指定資料庫或端點。

如要啟動 SQL 殼層，請執行下列指令：

spanner sql --database=DATABASE_NAME \
    --deployment-endpoint=LOAD_BALANCER_IP_OR_SERVER_IP:PORT

啟動 Shell 後，您會看到 sql> 提示：

spanner-cli>

如要退出殼層，請輸入 exit。