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

이 빠른 시작에서는 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>

Example:

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

Example:

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 유연한 서버를 사용하여 Postgres 데이터베이스에 대해 단일 쿼리를 실행합니다.

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

Example:

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 파일 실행

인수와 함께 --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

관련 콘텐츠

  • Last updated on