이 문서는 지원되지 않는 버전의 PostgreSQL 용입니다.
당신은에 대해 같은 페이지를 볼 수 있습니다현재버전 또는 위에 나열된 다른 지원 버전 중 하나입니다.

PSQL

이름

PSQL-Postgres대화식 클라이언트
psql [dbname]
psql -a [-c쿼리] [-ddbname]
    -e [-ffilename] [-f분리기] [-hhostname] -hln
    [-Ofilename] [-p포트] -qsst] [-ttable_options] -ux [dbname]

입력

PSQL많은 것을 받아들입니다 롤 토토 줄 인수, 풍부한 메타 롤 토토 세트 및 가득한SQL언어 지원Postgres. 가장 일반적인 롤 토토 줄 주장은 다음과 같습니다.

dbname

액세스 할 기존 데이터베이스의 이름.dbname값의 기본값사용자환경 변수 또는 if 현재 설정되지 않았습니다. 현재 UNIX 계정 이름으로 사용자.

-c쿼리

실행할 단일 쿼리.PSQL완료시 출구.

롤 토토 줄 인수 및 메타 롤 토토의 전체 세트는 다음과 같습니다 후속 섹션에 설명 됨

사용할 수있는 환경 변수가 있습니다. 롤 토토 줄 인수의 liu. 또한,Postgres프론트 엔드 라이브러리가 사용하는PSQL응용 프로그램을 찾습니다 예를 들어 구성 할 기타 선택적인 환경 변수 날짜/시간 표현 스타일 및 현지 시간대. 장을 참조하십시오.libpqin프로그래머 안내서더 많은 세부.

다음 환경 변수 중 하나를 설정할 수 있습니다. 롤 토토 줄 옵션 지정을 피하십시오 :

pghost

theDNS호스트 이름 데이터베이스 서버. 환경pghosta 0이 아닌 길이의 문자열 원인TCP/IP오히려 사용될 커뮤니케이션 기본 로컬 유닉스 도메인 소켓보다.

pgport

a 포트 번호Postgres서버가 듣고 있습니다. 기본값 에게5432.

pgtty

클라이언트의 메시지 표시 대상 지원 라이브러리. 필요하지 않습니다.

pgoption

ifpgoption가 지정됩니다 포함 된 옵션은 구문 분석됩니다모든 롤 토토 줄 옵션.

pgrealm

pgrealmKerberos인증은입니다 사용 중. 이 환경 변수가 설정되면Postgres인증을 시도합니다 이 영역 용 서버와 별도의 티켓을 사용합니다. 로컬 티켓 파일과의 충돌을 피하기위한 파일. 참조PostgreSQL 관리자 안내서추가 정보Kerberos.

출력

PSQL0을 쉘로 반환합니다 모든 쿼리를 성공적으로 완료하면 오류의 경우 1, 2 백엔드에서 갑자기 연결이 끊겼습니다. 기본 탭 구분자가 사용됩니다.PSQL의지 또한 데이터베이스에 연결할 수없는 경우 1 반환 1 어떤 이유로 든.

설명

PSQL는 캐릭터 기반입니다 프론트 엔드Postgres. 그것 대화식으로 쿼리를 입력 할 수 있습니다.Postgres그리고 쿼리를 참조하십시오 결과.

PSQLisPostgres클라이언트 응용 프로그램. 따라서 APostmaster프로세스가 있어야합니다 이전에 데이터베이스 서버 호스트에서 실행PSQL실행됩니다. 또한 올바른 와 같은 데이터베이스 서버를 식별하는 매개 변수Postmaster호스트 이름이 필요할 수 있습니다 아래에 설명 된대로 지정됩니다.

언제PSQL시작, 읽습니다 SQL 롤 토토에서/etc/psqlrc그리고 그런 다음 에서$ ()/. psqlrc이것은 SQL 롤 토토과 같은를 허용합니다.set날짜를 설정하는 데 사용할 수 있습니다 모든 세션의 시작 부분에서 실행할 스타일.

데이터베이스에 연결

PSQLa 호스트 이름 및 포트 번호의 데이터베이스 연결 롤 토토 줄에 지정됩니다. 연결을 할 수없는 경우 어떤 이유로 든 만들어졌습니다 (예 : 불충분 한 특권, 우체국 장 서버에서 실행되지 않음) .IRPSQL말하는 오류를 반환합니다

데이터베이스 연결 실패.
연결 고장의 이유는 제공되지 않습니다.

쿼리 입력

정상 작동 중PSQL데이터베이스 이름을 프롬프트합니다.PSQL현재 연결되어 있습니다 문자열 "="이 뒤 따릅니다. 예를 들어,

$psql testdbPostgreSQL 대화식 SQL 모니터에 오신 것을 환영합니다.
  PostgreSQL의 저작권 용어에 대한 저작권 파일을 읽으십시오.

   타입 \ e? 슬래시 롤 토토에 대한 도움
   종료하려면 \ eq를 입력하십시오
   \ EG를 입력하거나 세미콜론으로 종료하여 쿼리를 실행하십시오
 현재 데이터베이스에 연결되어 있습니다 : TestDB

testdb =

프롬프트에서 사용자가 입력 할 수 있습니다SQL쿼리. -S 옵션이 설정되지 않는 한 입력 라인은 쿼리가 말하면 백엔드로 전송됩니다. 세미콜론에 도달했습니다.

쿼리가 실행될 때마다PSQL비동기식에 대한 여론 조사 에 의해 생성 된 알림 이벤트듣기and알림.

PSQL파이프에서 사용할 수 있습니다 순서, 그리고 듣지 않을 때 자동으로 감지하거나 진짜 tty와 이야기.

롤 토토 줄 옵션

PSQL이해합니다 다음 롤 토토 줄 옵션 :

-a

테이블을 인쇄 할 때 채우기 정당화를 끄십시오 강요.

-c쿼리

이를 지정합니다PSQL하나의 쿼리 문자열 실행,쿼리그리고 나서 종료하십시오. 이것은 유용합니다 쉘 스크립트의 경우 일반적으로와 함께-Q쉘 스크립트의 옵션.

-ddbname

연결할 데이터베이스의 이름을 지정합니다. 이것은 지정에 해당dbname롤 토토의 마지막 필드로서 선.

-e

echo 백엔드로 전송 된 쿼리

-ffilename

파일 사용filenameAS 쿼리를 읽는 대신 쿼리 소스입니다 대화식. 이 파일은 지정되고 가시적되어야합니다 클라이언트 프론트 엔드.

-f분리기

use분리기필드로 분리 기호. 기본값은 ASCII 수직 막대 ( "|")입니다.

-hhostname

기계의 호스트 이름을 지정합니다.Postmaster실행 중입니다. 이 옵션이 없으면 통신은 로컬을 사용하여 수행됩니다 유닉스 도메인 소켓.

-h

켜기HTML 3.0표 산출.

-l

사용 가능한 모든 데이터베이스를 나열한 다음 종료하십시오. 다른 비 연결 옵션은 무시됩니다.

-n

입력 라인 편집 및 롤 토토 기록.

-ofilename

모든 출력을 파일에 넣습니다filename. 경로는 작성할 수 있어야합니다 클라이언트.

-p포트

TCP/IP 포트를 지정하거나 생략에 따라 로컬 UNIX 도메인 소켓 파일 확장Postmaster연결을 듣고 있습니다. 기본값의 값pgport환경 변수, 설정된 경우 또는 5432로

-Q

이를 지정합니다PSQL조용히 일을해야합니다. 기본적으로, 그것은 환영을 받고 있습니다 각 쿼리에 대한 메시지 및 프롬프트를 종료하고 쿼리에서 반환 된 행 수입니다. 이 옵션이 사용되는 경우 이런 일은 일어나지 않습니다. 이것은에 유용합니다.-c옵션.

-s

사용자가 프롬프트가있는 단일 단계 모드로 실행됩니다. 각 쿼리가 백엔드로 전송되기 전입니다.

-s

각 쿼리가 종료되는 단일 라인 모드에서 실행됩니다. 세미콜론 대신 Newline.

-t

열 이름의 인쇄를 끕니다. 이것은에 유용합니다.-c쉘 스크립트의 옵션.

-ttable_options

내에 배치 할 옵션을 지정할 수 있습니다테이블 ...tag forHTML 3.0표 출력. 예를 들어Border테이블을 제공합니다 국경. 이것은와 함께 사용해야합니다.-h옵션.

-u

사용자에게 사용자 이름과 비밀번호를 요청합니다. 데이터베이스에 연결. 데이터베이스에 필요하지 않은 경우 비밀번호 인증은 이들이 무시됩니다. 옵션 인 경우 사용되지 않습니다 (및 PGPassword 환경 변수는 세트) 및 데이터베이스에는 비밀번호 인증이 필요합니다 연결이 실패합니다. 사용자 이름은 무시됩니다 그래도.

-x

확장 행 형식 모드를 켭니다. 각 행을 활성화 한 경우 왼쪽에 열 이름이 인쇄됩니다. 열 값은 오른쪽에 인쇄되었습니다. 이것은 행에 유용합니다 그렇지 않으면 하나의 스크린 라인에 적합하기에는 너무 길다. HTML 행 출력은이 모드도 지원합니다.

일부 타이핑을 피하기 위해 환경 변수를 설정할 수 있습니다. 위의 옵션. 환경 변수 섹션을 참조하십시오 아래에.

PSQLMeta-Commands

당신이 입력하는 모든 것PSQL인용되지 않은 백 슬래시로 시작하는 것은입니다.PSQL메타 롤 토토. 다른 것은SQL단순히 전류로 들어갑니다 쿼리 버퍼 (일단 하나 이상의 완전한 쿼리가 있으면 자동으로 백엔드에 제출됩니다).PSQL메타 롤 토토을 슬래시라고도합니다 롤 토토.

a의 형식PSQL롤 토토 백 슬래시, 그리고 즉시 롤 토토 동사가 이어집니다. 모든 주장. 인수는 롤 토토 동사와 분리되어 있습니다 그리고 여러 공백 캐릭터에 의해 서로에 의해 서로.

단일 문자 롤 토토 동사를 사용하면 실제로 필요하지 않습니다 롤 토토 동사를 공백과의 인수와 분리하려면 역사적 이유로. 어쨌든 당신은해야합니다.

다음 메타 롤 토토이 정의되어 있습니다.

\ a

테이블을 인쇄 할 때 필드 정렬 토글 강요.

\ c 캡션

HTML3.0 테이블 캡션을“로 설정캡션”.

\ connect dbname[사용자 이름]

기본사용자 이름없다면 지정되었습니다. 이전 연결이 닫혔습니다.

\ copy dbnamefrom | 에게filename

프론트 엔드 (클라이언트) 사본을 수행하십시오. 이것은 작전입니다 SQL Copy 롤 토토을 실행하지만 백엔드 대신 지정된 파일을 읽거나 쓰는 결과 백엔드 액세스 및 특별 사용자 권한 요구,PSQL읽거나 씁니다 파일을 파일하고 데이터를 백엔드로 또는 구사합니다. 기본값구분 기가 사용됩니다.

팁 :이 작업은만큼 효율적이지 않습니다.SQL copy모든 데이터가 전달되어야하므로 롤 토토 클라이언트/서버 IP 또는 소켓 연결을 통해 을 위한 많은 양의 데이터이 다른 기술이있을 수 있습니다 선택할 만한.

\ d[테이블]

데이터베이스에 테이블을 나열하거나 if테이블지정되어 있습니다. 열을 나열하십시오 그 테이블. 테이블 이름이 별표 ( "*")로 지정된 경우 각 테이블에 대한 모든 테이블 및 열 정보를 나열합니다.

\ da

사용 가능한 모든 집계 목록.

\ dd 개체

설명을 나열하여pg_description21367_21472

팁 :모든 객체에 설명이있는 것은 아닙니다pg_description. 이 메타 롤 토토 네이티브에 대한 빠른 설명을 얻는 데 유용 할 수 있습니다Postgres기능.

\ df

목록 기능.

\ di

인덱스 만 목록.

\ do

목록 전용 연산자.

\ ds

순서 만 목록.

\ ds

시스템 테이블 및 인덱스 목록.

\ dt

비 시스템 테이블 만 나열하십시오.

\ dt

목록 유형.

\ e[filename]

현재 쿼리 버퍼 또는 파일의 내용 편집filename.

\ e[filename]

현재 쿼리 버퍼 또는 파일의 내용 편집filename그리고 그것을 실행하십시오 편집기 출구.

\ f[분리기]

필드 분리기를 설정합니다. 기본값은 단일 빈입니다 공간.

\ g[filename | |롤 토토]

현재 쿼리 입력 버퍼를 백엔드로 보내고 선택적으로 출력을 저장filename또는 출력을 a로 파이프합니다 실행하려면 별도의 유닉스 쉘롤 토토.

\ H[롤 토토]

지정된 SQL 롤 토토에 구문 도움말을 제공합니다. 만약에롤 토토정의 된 SQL이 아닙니다 롤 토토 (또는 문서화되지 않음PSQL) 또는 if롤 토토지정되지 않은 다음PSQL모든 것을 나열합니다 Syntax 도움말을 사용할 수있는 롤 토토. 만약에롤 토토는 별표 (“*”)입니다 모든 SQL 롤 토토에 대한 구문 도움말.

\ H

토글html3출력. 이것은 에 해당합니다.-h롤 토토 줄 옵션.

\ i filename

파일에서 쿼리 읽기filename쿼리 입력에 완충기.

\ l

서버의 모든 데이터베이스를 나열합니다.

\ m

이전 모니터와 같은 테이블 디스플레이를 전환합니다 테이블을 둘러싼 테두리 문자. 이것은 표준 SQL입니다 산출. 기본적으로PSQL열 사이의 필드 분리기 만 포함합니다.

\ O[filename | |롤 토토]

향후 쿼리 결과를 파일에 저장filename또는 파이프 미래 결과 a 실행하려면 별도의 유닉스 쉘롤 토토. 인수가 지정되지 않으면 쿼리 결과를Stdout.

\ p

현재 쿼리 버퍼 인쇄.

\ Q

종료PSQL프로그램.

\ r

쿼리 버퍼 재설정 (Clear)

\ s[filename]

롤 토토 줄 기록을 인쇄하거나 저장filename. 만약에filename생략되면 저장하지 마십시오 히스토리 파일에 대한 후속 롤 토토. 이 옵션은 전용입니다 사용 가능PSQLIS readline을 사용하도록 구성되었습니다.

\ t

출력 열 이름 제목 및 행의 전환 표시 바닥 글 (기본값으로).

\ t table_options

내에 배치 할 옵션을 지정할 수 있습니다테이블 ...tag forHTML 3.0표 출력. 예를 들어국경테이블을 제공합니다 국경. 이것은와 함께 사용해야합니다.\ HMeta-Command.

\ x

확장 행 형식 모드 토글. 각 행을 활성화 한 경우 왼쪽에 열 이름이 인쇄됩니다. 열 값은 오른쪽에 인쇄되었습니다. 이것은 행에 유용합니다 그렇지 않으면 하나의 스크린 라인에 맞기에는 너무 길다.html행 출력 모드가 지원됩니다 이 깃발도.

\ w filename

현재 쿼리 버퍼를 파일에 출력합니다filename.

\ z

데이터베이스에서 모든 테이블 목록을 생성합니다. 적절한 ACL (Grant/Revoke 권한)이 나열되어 있습니다.

\![롤 토토]

별도의 유닉스 쉘로 탈출하거나 유닉스를 실행하십시오. 롤 토토롤 토토.

\?

슬래시 (“\”) 롤 토토에 대한 도움말 정보 받기.