Configurar o Spanner Omni

Nesta página, descrevemos como iniciar o Spanner Omni no modo de servidor único. É possível instalar usando um arquivo TAR ou executar como um contêiner usando o Docker.

Antes de começar

Antes de configurar sua instância do Spanner Omni, verifique se você atende aos seguintes requisitos:

  • Verifique se a máquina atende aos requisitos do sistema.

  • Verifique se você tem acesso de sudo no seu ambiente para configurar o binário do Spanner Omni.

  • Verifique se o Docker está instalado na sua máquina para instalações baseadas em contêineres.

Executar usando o Docker

Recomendamos armazenar dados do Spanner em um volume do Docker para garantir a persistência dos dados se você excluir o contêiner.

  1. Crie um volume do Docker:

    docker volume create spanner

  2. Inicie o contêiner do servidor do Spanner Omni. Substitua VERSION_TAG pela versão do Spanner Omni que você quer usar. A versão atual é 2026.r1-beta.

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

    A flag --network host mapeia as portas do Spanner Omni para a máquina host.

  3. Verifique se o contêiner está em execução:

    docker ps

    Verifique o campo STATUS na saída para garantir que o contêiner esteja íntegro.

Interagir com o servidor em contêiner

Você pode usar o docker exec para executar comandos da CLI do Spanner Omni dentro do contêiner:

  1. Crie um banco de dados.

    docker exec -it spanneromni /google/spanner/bin/spanner databases create DATABASE_NAME

  2. Abra o shell do SQL:

    docker exec -it spanneromni /google/spanner/bin/spanner sql --database=DATABASE_NAME

  3. Listar bancos de dados:

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