AlloyDB Omni 실행 및 연결

문서 버전을 선택합니다.

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

AlloyDB Omni 실행

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

AlloyDB Omni 시작

중지된 AlloyDB Omni 컨테이너를 시작하려면 docker container start 명령어 또는 podman container start 명령어를 실행합니다.

Docker 

docker container start CONTAINER_NAME

CONTAINER_NAME을 AlloyDB Omni 컨테이너를 설치할 때 할당한 이름으로 바꿉니다.

Podman 

podman container start CONTAINER_NAME

CONTAINER_NAME을 AlloyDB Omni 컨테이너를 설치할 때 할당한 이름으로 바꿉니다.

AlloyDB Omni 상태 확인

실행 중인 모든 컨테이너의 상태를 확인하려면 docker container ls 명령어 또는 podman container ls 명령어를 실행합니다.

Docker 

docker container ls

Podman 

podman container ls

AlloyDB Omni 컨테이너가 실행 중이면 이름이 출력 테이블의 NAMES 열에 표시됩니다. 해당 행에는 컨테이너 상태가 요약되어 있습니다.

컨테이너 이름이 NAMES 열에 표시되지 않으면 AlloyDB Omni가 실행되고 있지 않은 것입니다.

AlloyDB Omni 중지

AlloyDB Omni 컨테이너를 중지하려면 docker container stop 명령어 또는 podman container stop 명령어를 실행합니다.

Docker 

  docker container stop CONTAINER_NAME

CONTAINER_NAME을 AlloyDB Omni 컨테이너를 설치할 때 할당한 이름으로 바꿉니다.

Podman 

  podman container stop CONTAINER_NAME

CONTAINER_NAME을 AlloyDB Omni 컨테이너를 설치할 때 할당한 이름으로 바꿉니다.

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

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

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

Kubernetes 클러스터에서 실행되는 AlloyDB Omni 데이터베이스 클러스터에 연결하는 방법은 Kubernetes에서 실행되는 AlloyDB Omni에 연결을 참조하세요.

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

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

Docker 

  docker exec -it CONTAINER_NAME psql -U postgres

CONTAINER_NAME을 AlloyDB Omni 컨테이너를 설치할 때 할당한 이름으로 바꿉니다.

Podman 

  podman exec -it CONTAINER_NAME psql -U postgres

CONTAINER_NAME을 AlloyDB Omni 컨테이너를 설치할 때 할당한 이름으로 바꿉니다.

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

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

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

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

AlloyDB Omni 데이터베이스 서버에 연결하려면 AlloyDB Omni를 시작할 때 docker run 또는 podman run 명령어에 --network=host 또는 -p 5432:5432를 추가하여 AlloyDB Omni Docker 컨테이너에서 호스트 머신으로 네트워킹을 노출합니다.

커스텀 포트 번호를 선택하려면 AlloyDB Omni를 시작할 때 -p [HOST_PORT]:5432를 사용합니다. 그런 다음 PostgreSQL 호환 클라이언트나 코드 라이브러리를 사용하여 포트 5432 또는 지정한 커스텀 포트 번호에 연결합니다.

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

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

다음 단계