設定 Spanner Omni

本頁說明如何以單一伺服器模式啟動 Spanner Omni。您可以使用 TAR 檔案安裝,也可以透過 Docker 以容器形式執行。

事前準備

設定 Spanner Omni 執行個體前,請確認您符合下列需求:

  • 確認機器符合系統需求。

  • 請確認您在環境中具備 sudo 存取權,以便設定 Spanner Omni 二進位檔。

  • 如要安裝容器,請確認機器已安裝 Docker。

使用 Docker 執行

建議您將 Spanner 資料儲存在 Docker 磁碟區,確保刪除容器後資料仍會保留。

  1. 建立 Docker 磁碟區:

    docker volume create spanner
    
  2. 啟動 Spanner Omni 伺服器容器。將 VERSION_TAG 替換為要使用的 Spanner Omni 版本。目前版本為 2026.r4-lts.1。

    docker run -d --network host \
        --name spanneromni \
        -v "spanner:/spanner" \
        us-docker.pkg.dev/spanner-omni/images/spanner-omni:VERSION_TAG \
        start-single-server
    

    --network host 旗標會將 Spanner Omni 通訊埠對應至主機。

  3. 請確認容器是否正在執行:

    docker ps
    

    查看輸出內容中的「STATUS」欄位,確認容器健康狀態良好。

與容器化伺服器互動

您可以使用 docker exec 在容器內執行 Spanner Omni CLI 指令:

  1. 建立資料庫:

    docker exec -it spanneromni /google/spanner/bin/spanner databases create DATABASE_NAME
    
  2. 開啟 SQL 殼層:

    docker exec -it spanneromni /google/spanner/bin/spanner sql --database=DATABASE_NAME
    
  3. 列出資料庫:

    docker exec -it spanneromni /google/spanner/bin/spanner databases list