다음을 통해 공유

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

  • 아티클

적용 대상: 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"

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

Running sql file 'test.sql'...
Successfully executed the file.
Closed the connection to server372060240

다음 단계

서버 관리