빠른 시작: Azure Database for PostgreSQL 유연한 서버를 사용하여 Azure CLI로 연결 및 쿼리

아티클
05/14/2024

적용 대상: Azure Database for PostgreSQL - 유연한 서버

이 빠른 시작에서는 az postgres flexible-server connect에서 Azure CLI를 사용하여 Azure Database for PostgreSQL 유연한 서버 인스턴스에 연결하고 az postgres flexible-server execute 명령을 통해 단일 쿼리 또는 sql 파일을 실행하는 방법을 보여줍니다. 이 명령을 사용하면 데이터베이스 서버에 대한 연결을 테스트하고 쿼리를 실행할 수 있습니다. 대화형 모드를 사용하여 여러 쿼리를 실행할 수도 있습니다.

필수 조건

활성 구독이 있는 Azure 계정. 계정이 없으면 체험 계정을 얻습니다.
Azure CLI 최신 버전 설치
Azure CLI에서 az login 명령을 사용하여 로그인
(선택 사항) az config param-persist on을 사용하여 실험적 매개 변수 지속성을 설정합니다. 매개 변수 지속성은 리소스 그룹이나 위치 등의 여러가지 인수를 반복하지 않고도 로컬 컨텍스트를 사용할 수 있도록 도와줍니다.

Azure Database for PostgreSQL 유연한 서버 인스턴스 만들기

가장 먼저 만드는 것은 관리되는 Azure Database for PostgreSQL 유연한 서버 인스턴스입니다. Azure Cloud Shell에서 다음 스크립트를 실행하고 이 명령에서 생성된 서버 이름, **사용자 이름 및 암호를 기록해 둡니다.

az postgres flexible-server create --public-access <your-ip-address>

이 명령에 대한 추가 인수를 제공하여 사용자 지정할 수 있습니다. az postgres flexible-server create에 대한 모든 인수를 참조하세요.

모든 인수 보기

--help 인수를 사용하여 이 명령에 대한 모든 인수를 볼 수 있습니다.

az postgres flexible-server connect --help

데이터베이스 서버 연결 테스트

az postgres flexible-server connect 명령을 사용하여 개발 환경에서 데이터베이스에 대한 연결을 테스트하고 유효성을 검사할 수 있습니다.

az postgres flexible-server connect \
    -n <servername> -u <username> -p "<password>" -d <databasename>

예제:

az postgres flexible-server connect \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres

연결이 성공하면 유사한 출력이 표시됩니다.

Successfully connected to server372060240.

연결에 실패한 경우 다음 사항을 확인하세요.

서버 관리자의 사용자 이름 및 암호가 올바른 경우
클라이언트 머신에 대한 방화벽 규칙을 구성한 경우
서버가 가상 네트워킹을 사용하여 프라이빗 액세스로 구성된 경우 클라이언트 머신이 동일한 가상 네트워크에 있는지 확인합니다.

대화형 모드를 사용하여 여러 쿼리 실행

대화형 모드를 사용하여 여러 쿼리를 실행할 수 있습니다. 대화형 모드를 활성화하려면 다음 명령을 실행합니다.

az postgres flexible-server connect \
    -n <servername> -u <username> -p "<password>" -d <databasename> \
    --interactive

예제:

az postgres flexible-server connect \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres --interactive

다음과 같이 psql 셸 환경이 표시됩니다.

Password for starchylapwing9:
Server: PostgreSQL 13.14
Version: 4.0.1
Home: http://pgcli.com
postgres> SELECT 1;
+----------+
| ?column? |
|----------|
| 1        |
+----------+
SELECT 1
Time: 0.167s
postgres>

단일 쿼리 실행

az postgres flexible-server execute를 사용하여 Postgres 데이터베이스에 대해 단일 쿼리를 실행할 수 있습니다.

az postgres flexible-server execute \
    -n <servername> -u <username> -p "<password>" -d <databasename> \
    -q <querytext> --output table

예제:

az postgres flexible-server execute \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
    -q "SELECT 1" --output table

다음과 같이 출력이 표시됩니다.

Successfully connected to server372060240.
Ran Database Query: 'SELECT 1'
Retrieving first 30 rows of query output, if applicable.
Closed the connection to server372060240
?column?
----------
1

SQL 파일 실행

az postgres flexible-server execute 명령에서 --file-path 인수 -f를 사용하여 sql 파일을 실행할 수 있습니다.

az postgres flexible-server execute \
    -n <server-name> -u <username> -p "<password>" -d <database-name> \
    --file-path "<file-path>"

예: test.sql 파일을 준비합니다. 간단한 SELECT 쿼리와 함께 다음 테스트 스크립트를 사용할 수 있습니다.

SELECT 1;
SELECT 2;
SELECT 3;

현재 디렉터리의 test.sql 파일에 콘텐츠를 저장하고 다음 명령을 사용하여 실행합니다.

az postgres flexible-server execute \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
    -f "test.sql"