AlloyDB Omni 실행 및 연결

문서 버전을 선택합니다.

이 페이지에서는 자체 머신에 설치한 후 AlloyDB Omni를 실행하고 연결하는 방법을 설명합니다.

시작하기 전에

이 페이지의 대부분의 명령어는 AlloyDB Omni CLI를 사용합니다.

머신에 이 명령줄 도구를 설치하려면 AlloyDB Omni CLI 설치를 참고하세요.

AlloyDB Omni 실행

AlloyDB Omni를 실행하는 데 사용하는 절차는 단일 서버의 컨테이너에서 AlloyDB Omni를 실행하는지 여부에 따라 달라집니다.

AlloyDB Omni를 설치하면 머신이 부팅될 때마다 실행되도록 구성된 alloydb-dataplane라는 시스템 서비스가 설정됩니다.

AlloyDB Omni의 기본 제어 및 모니터링에는 다음 섹션에 설명된 대로 sudo alloydb 명령어를 사용합니다.

AlloyDB Omni 시작

sudo alloydb database-server start

테스트 연결을 실행하려면 컨테이너화된 psql을 사용하여 연결을 참고하세요.

AlloyDB Omni 상태 확인

sudo alloydb database-server status

AlloyDB Omni 중지

sudo alloydb database-server stop

시작 시 실행 사용 중지

다음 명령어를 실행하면 머신이 부팅될 때 AlloyDB Omni가 자동으로 시작되지 않습니다.

sudo systemctl disable alloydb-dataplane

시작 시 실행 다시 사용 설정

  sudo systemctl enable alloydb-dataplane

단일 서버에서 실행되는 AlloyDB Omni에 연결

AlloyDB Omni 컨테이너에는 데이터베이스 서버로 대화형 SQL 셸 세션을 열 수 있는 자체 psql 사본이 포함되어 있습니다.

원하는 PostgreSQL 호환 소프트웨어를 사용하여 컨테이너 외부에서 AlloyDB Omni에 연결할 수도 있습니다.

컨테이너화된 psql을 사용하여 연결

자체 컨테이너화된 psql 사본을 사용하여 AlloyDB Omni 데이터베이스 서버에 연결하려면 다음 명령어를 실행합니다.

단일 서버 

docker exec -it pg-service psql -h localhost -U postgres

이 명령어는 postgres 사용자 역할로 개발자를 서버에 연결하고 postgres=# 명령 프롬프트를 표시합니다. 이제 psql 명령어와 SQL 쿼리를 실행할 수 있습니다.

psql을 종료하려면 \q 명령어를 실행합니다.

자체 애플리케이션을 사용하여 연결

PostgreSQL에서 작동하는 애플리케이션은 수정할 필요 없이 AlloyDB Omni에서도 작동합니다.

AlloyDB Omni 데이터베이스 서버에 연결하려면 PostgreSQL 호환 클라이언트 또는 코드 라이브러리를 사용하여 AlloyDB Omni를 실행하는 머신의 기본 PostgreSQL 데이터베이스 서버 포트인 포트 5432에 연결합니다.

AlloyDB Omni 컨테이너가 실행되는 머신의 동일한 포트에 자체 포트 5432를 노출하므로 이 방법이 작동합니다.

데이터베이스 서버에 연결한 후 표준 PostgreSQL 통신 프로토콜을 사용하여 DML 및 SQL 쿼리를 통해 데이터베이스를 정의, 쿼리, 수정할 수 있습니다.

AlloyDB Omni는 자체 환경 내에서 실행되므로 AlloyDB Omni에 연결하는 방법을 제어할 수 있습니다. 여기에는 일반 PostgreSQL 서버와 마찬가지로 애플리케이션 니즈에 따라 이 서비스에 대한 네트워크 액세스를 허용하거나 제한하는 것이 포함됩니다.

다음 단계