이 문서에서는 Spanner Omni 명령줄 인터페이스(CLI)를 사용하여 Spanner Omni 배포와 상호작용하고 이를 관리하는 방법을 보여줍니다. Spanner Omni CLI는 일반적인 관리 작업을 위한 명령어를 제공하며 데이터베이스를 쿼리하기 위한 대화형 SQL 셸을 포함합니다.
시작하기 전에
Spanner Omni CLI를 사용하려면 다음 요구사항을 충족해야 합니다.
- Spanner Omni 배포가 설정되어 실행 중입니다.
- Spanner Omni CLI를 실행하는 머신이 Spanner Omni 배포의 부하 분산기 또는 배포의 서버 중 하나 이상에 대한 네트워크 액세스 권한이 있습니다.
1단계: Spanner Omni CLI 다운로드 및 설치
spanner-omniCloud Storage 버킷에서 Spanner Omni CLI를 다운로드합니다.tar 파일의 압축을 풉니다.
tar -xvf CLI_TAR_FILE이렇게 하면
google/spanner/bin디렉터리에spanner라는 Spanner Omni CLI 바이너리가 설치됩니다.spanner명령어를 실행하려면PATH환경 변수에google/spanner/bin디렉터리를 추가하거나 다음 단계에서 바이너리의 전체 경로를 사용하세요.
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
셸이 시작되면 sql> 프롬프트가 표시됩니다.
spanner-cli>
셸을 종료하려면 exit를 입력합니다.