Spanner Omni 설정

이 페이지에서는 단일 서버 모드에서 Spanner Omni를 시작하는 방법을 설명합니다. TAR 파일을 사용하여 설치하거나 Docker를 사용하여 컨테이너로 실행할 수 있습니다.

시작하기 전에

Spanner Omni 인스턴스를 설정하기 전에 다음 요구사항을 충족하는지 확인하세요.

  • 머신이 시스템 요구사항을 충족하는지 확인합니다.

  • Spanner Omni 바이너리를 설정하려면 환경에서 sudo 액세스 권한이 있어야 합니다.

  • 컨테이너 기반 설치를 위해 Docker가 머신에 설치되어 있어야 합니다.

Docker를 사용하여 실행

컨테이너를 삭제하는 경우 데이터 지속성을 보장하려면 Docker 볼륨에 Spanner 데이터를 저장하는 것이 좋습니다.

  1. Docker 볼륨을 만듭니다.

    docker volume create spanner

  2. Spanner Omni 서버 컨테이너를 시작합니다. VERSION_TAG를 사용하려는 Spanner Omni 버전으로 바꿉니다. 현재 버전은 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

    --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