다음은 Azure Storage 확장에서 제공하는 함수 목록입니다.
azure_storage.account_add
확장에서 액세스할 수 있는 스토리지 계정 목록에 스토리지 계정 및 연결된 액세스 키를 추가할 수 있는 azure_storage 함수입니다.
이 함수의 이전 호출에서 이 스토리지 계정에 대한 참조를 이미 추가한 경우 새 항목을 추가하지 않고 기존 항목의 액세스 키를 업데이트합니다.
비고
이 함수는 참조된 계정 이름이 있는지 또는 제공된 액세스 키를 사용하여 액세스할 수 있는지 여부를 확인하지 않습니다. 그러나 Azure Storage 계정에 적용되는 명명 유효성 검사 규칙에 따라 스토리지 계정의 이름이 유효한지 확인합니다.
azure_storage.account_add(account_name_p text, account_key_p text);
참조된 Azure Storage 계정의 이름과 인증 유형, 계정 유형 또는 스토리지 자격 증명과 같은 모든 필수 설정을 캡슐화하는 매개 변수를 허용하는 account_config 이 함수의 오버로드된 버전이 있습니다.
azure_storage.account_add(account_config jsonb);
권한
의 azure_storage_admin멤버여야 합니다.
주장들
account_name_p
text Blob, 파일, 큐 및 테이블과 같은 모든 개체를 포함하는 Azure Blob Storage 계정의 이름입니다. 스토리지 계정은 HTTPS를 통해 전 세계 어디에서나 액세스할 수 있는 고유한 네임스페이스를 제공합니다.
account_key_p
text 스토리지 계정에 대한 액세스 키 중 하나의 값입니다. Azure Blob Storage 액세스 키는 스토리지 계정의 루트 암호와 유사합니다. 항상 액세스 키를 보호해야 합니다. Azure Key Vault를 사용하여 키를 안전하게 관리하고 회전합니다. 계정 키는 슈퍼 사용자만 액세스할 수 있는 테이블에 저장됩니다. 역할이 부여된 사용자는 함수를 azure_storage_admin 통해 이 테이블과 상호 작용할 수 있습니다. 추가되는 스토리지 계정을 확인하려면 azure_storage.account_list 함수를 사용합니다.
account_config
jsonb Azure Storage 계정의 이름 및 인증 유형, 계정 유형 또는 스토리지 자격 증명과 같은 모든 필수 설정입니다. 유틸리티 함수 azure_storage.account_options_managed_identity, azure_storage.account_options_credentials 또는 azure_storage.account_options 를 사용하여 이 인수로 전달되어야 하는 유효한 값을 만드는 것이 좋습니다.
반환 형식
VOID
azure_storage.account_options_managed_identity
유틸리티 함수 역할을 하는 함수로, azure_storage.account_add 내에서 매개 변수로 호출할 수 있으며 시스템 할당 관리 ID를 사용하여 Azure Storage 계정과 상호 작용할 때 인수에 유효한 값을 account_config 생성하는 데 유용합니다.
azure_storage.account_options_managed_identity(name text, type azure_storage.storage_type);
권한
모든 사용자 또는 역할은 이 함수를 호출할 수 있습니다.
주장들
이름
text Blob, 파일, 큐 및 테이블과 같은 모든 개체를 포함하는 Azure Blob Storage 계정의 이름입니다. 스토리지 계정은 HTTPS를 통해 전 세계 어디에서나 액세스할 수 있는 고유한 네임스페이스를 제공합니다.
유형
azure_storage.storage_type 지원되는 스토리지 유형 중 하나의 값입니다. 지원되는 값만 .blob
반환 형식
jsonb
azure_storage.account_options_credentials
유틸리티 함수 역할을 하는 함수로, azure_storage.account_add 내에서 매개 변수로 호출할 수 있으며 Azure Storage 액세스 키를 사용하여 Azure Storage 계정과 상호 작용할 때 인수에 유효한 값을 account_config 생성하는 데 유용합니다.
azure_storage.account_options_credentials(name text, credentials text, type azure_storage.storage_type);
권한
모든 사용자 또는 역할은 이 함수를 호출할 수 있습니다.
주장들
이름
text Blob, 파일, 큐 및 테이블과 같은 모든 개체를 포함하는 Azure Blob Storage 계정의 이름입니다. 스토리지 계정은 HTTPS를 통해 전 세계 어디에서나 액세스할 수 있는 고유한 네임스페이스를 제공합니다.
자격 증명
text 스토리지 계정에 대한 액세스 키 중 하나의 값입니다. Azure Blob Storage 액세스 키는 스토리지 계정의 루트 암호와 유사합니다. 항상 액세스 키를 보호해야 합니다. Azure Key Vault를 사용하여 키를 안전하게 관리하고 회전합니다. 계정 키는 슈퍼 사용자만 액세스할 수 있는 테이블에 저장됩니다. 역할이 부여된 사용자는 함수를 azure_storage_admin 통해 이 테이블과 상호 작용할 수 있습니다. 추가되는 스토리지 계정을 확인하려면 azure_storage.account_list 함수를 사용합니다.
유형
azure_storage.storage_type 지원되는 스토리지 유형 중 하나의 값입니다. 지원되는 값만 .blob
반환 형식
jsonb
azure_storage.account_options
유틸리티 함수 역할을 하는 함수로, azure_storage.account_add 내에서 매개 변수로 호출할 수 있으며 Azure Storage 액세스 키 또는 시스템 할당 관리 ID를 사용하여 Azure Storage 계정과 상호 작용할 때 인수에 유효한 값을 account_config 생성하는 데 유용합니다.
azure_storage.account_options(name text, auth_type azure_storage.auth_type, storage_type azure_storage.storage_type, credentials text DEFAULT NULL);
권한
모든 사용자 또는 역할은 이 함수를 호출할 수 있습니다.
주장들
이름
text Blob, 파일, 큐 및 테이블과 같은 모든 개체를 포함하는 Azure Blob Storage 계정의 이름입니다. 스토리지 계정은 HTTPS를 통해 전 세계 어디에서나 액세스할 수 있는 고유한 네임스페이스를 제공합니다.
auth_type
azure_storage.auth_type 지원되는 스토리지 유형 중 하나의 값입니다. 지원되는 값 access-key만 , 및 managed-identity.
storage_type
azure_storage.storage_type 지원되는 스토리지 유형 중 하나의 값입니다. 지원되는 값만 .blob
자격 증명
text 스토리지 계정에 대한 액세스 키 중 하나의 값입니다. Azure Blob Storage 액세스 키는 스토리지 계정의 루트 암호와 유사합니다. 항상 액세스 키를 보호해야 합니다. Azure Key Vault를 사용하여 키를 안전하게 관리하고 회전합니다. 계정 키는 슈퍼 사용자만 액세스할 수 있는 테이블에 저장됩니다. 역할이 부여된 사용자는 함수를 azure_storage_admin 통해 이 테이블과 상호 작용할 수 있습니다. 추가되는 스토리지 계정을 확인하려면 azure_storage.account_list 함수를 사용합니다.
반환 형식
jsonb
azure_storage.account_remove
확장에서 액세스할 수 있는 스토리지 계정 목록에서 스토리지 계정 및 연결된 액세스 키를 제거할 수 있는 azure_storage 함수입니다.
azure_storage.account_remove(account_name_p text);
권한
의 azure_storage_admin멤버여야 합니다.
주장들
account_name_p
text Blob, 파일, 큐 및 테이블과 같은 모든 개체를 포함하는 Azure Blob Storage 계정의 이름입니다. 스토리지 계정은 HTTPS를 통해 전 세계 어디에서나 액세스할 수 있는 고유한 네임스페이스를 제공합니다.
반환 형식
VOID
azure_storage.account_user_add
확장에서 제공하는 azure_storage 함수를 통해 PostgreSQL 사용자 또는 역할 액세스 권한을 스토리지 계정에 부여할 수 있는 함수입니다.
비고
이 함수의 실행은 이름이 첫 번째 인수로 전달되는 스토리지 계정이 azure_storage.account_add를 사용하여 이미 만들어졌으며 이름이 두 번째 인수로 전달된 사용자 또는 역할이 이미 있는 경우에만 성공합니다.
azure_storage.account_add(account_name_p text, user_p regrole);
권한
의 azure_storage_admin멤버여야 합니다.
주장들
account_name_p
text Blob, 파일, 큐 및 테이블과 같은 모든 개체를 포함하는 Azure Blob Storage 계정의 이름입니다. 스토리지 계정은 HTTPS를 통해 전 세계 어디에서나 액세스할 수 있는 고유한 네임스페이스를 제공합니다.
user_p
regrole 서버에서 사용할 수 있는 PostgreSQL 사용자 또는 역할의 이름입니다.
반환 형식
VOID
azure_storage.account_user_remove
확장에서 제공하는 azure_storage 함수를 통해 스토리지 계정에 대한 PostgreSQL 사용자 또는 역할 액세스를 해지할 수 있는 함수입니다.
비고
이 함수의 실행은 이름이 첫 번째 인수로 전달되는 스토리지 계정이 azure_storage.account_add를 사용하여 이미 만들어진 경우와 이름이 두 번째 인수로 전달된 사용자 또는 역할이 여전히 존재하는 경우에만 성공합니다.
서버에서 사용자 또는 역할이 삭제되면 실행하여 DROP USER | ROLEAzure Storage 계정에 대한 모든 참조에 부여된 권한도 자동으로 제거됩니다.
azure_storage.account_user_remove(account_name_p text, user_p regrole);
권한
의 azure_storage_admin멤버여야 합니다.
주장들
account_name_p
text Blob, 파일, 큐 및 테이블과 같은 모든 개체를 포함하는 Azure Blob Storage 계정의 이름입니다. 스토리지 계정은 HTTPS를 통해 전 세계 어디에서나 액세스할 수 있는 고유한 네임스페이스를 제공합니다.
user_p
regrole 서버에서 사용할 수 있는 PostgreSQL 사용자 또는 역할의 이름입니다.
반환 형식
VOID
azure_storage.account_list
확장에서 제공하는 함수를 통해 해당 스토리지 계정과 상호 작용할 수 있는 권한이 부여된 PostgreSQL 사용자 또는 역할과 함께 azure_storage 함수를 통해 구성된 스토리지 계정의 이름을 나열하는 함수입니다.
azure_storage.account_list();
권한
의 azure_storage_admin멤버여야 합니다.
주장들
이 함수는 인수를 취하지 않습니다.
반환 형식
TABLE(account_name text, auth_type azure_storage.auth_type, azure_storage_type azure_storage.storage_type, allowed_users regrole[]) Azure Storage 계정 목록이 추가된 4열 테이블, 각 계정과 상호 작용하는 데 사용되는 인증 유형, 스토리지 유형 및 액세스 권한이 부여된 PostgreSQL 사용자 또는 역할 목록이 있습니다.
azure_storage.blob_list
참조된 스토리지 계정의 지정된 컨테이너에 저장된 Blob의 이름 및 기타 속성(크기, lastModified, eTag, contentType, contentEncoding 및 contentHash)을 나열하는 함수입니다.
azure_storage.blob_list(account_name text, container_name text, prefix text DEFAULT ''::text);
권한
이 함수를 호출하는 사용자 또는 역할은 account_name를 실행하여 참조된 항목의 허용 목록에 추가해야 합니다. 멤버 azure_storage_admin 는 azure_storage.account_add를 사용하여 참조가 추가된 모든 Azure Storage 계정을 자동으로 참조할 수 있습니다.
주장들
account_name
text Blob, 파일, 큐 및 테이블과 같은 모든 개체를 포함하는 Azure Blob Storage 계정의 이름입니다. 스토리지 계정은 HTTPS를 통해 전 세계 어디에서나 액세스할 수 있는 고유한 네임스페이스를 제공합니다.
컨테이너_이름
text 컨테이너의 이름입니다. 컨테이너는 파일 시스템의 디렉터리와 유사한 Blob 집합을 구성합니다. 스토리지 계정에는 무제한의 컨테이너가 포함될 수 있으며 컨테이너는 무제한의 Blob을 저장할 수 있습니다.
컨테이너 이름은 컨테이너 또는 해당 Blob의 주소를 지정하는 데 사용되는 고유한 URI의 일부를 구성하므로 유효한 DNS(도메인 이름 시스템) 이름이어야 합니다.
컨테이너 이름을 지정할 때 는 다음 규칙을 따라야 합니다.
컨테이너의 URI는 다음과 유사합니다. https://myaccount.blob.core.windows.net/mycontainer
접두사
text 지정된 경우 함수는 이름이 이 매개 변수에 제공된 값으로 시작하는 Blob을 반환합니다. 기본값은 빈 문자열입니다.
반환 형식
TABLE(path text, bytes bigint, last_modified timestamp with time zone, etag text, content_type text, content_encoding text, content_hash text) Blob의 전체 이름 및 기타 속성을 포함하여 반환된 Blob당 하나의 레코드가 있는 테이블입니다.
길
text Blob의 전체 이름입니다.
바이트
bigint Blob 크기(바이트)입니다.
last_modified
timestamp with time zoneBlob이 마지막으로 수정된 날짜 및 시간입니다. blob의 메타데이터 또는 속성에 대한 업데이트를 포함하여 Blob을 수정하는 모든 작업은 수행할 경우 Blob의 마지막 수정 시간이 변경됩니다.
ETAG
text ETag 속성은 업데이트 중에 낙관적 동시성에 사용됩니다. 레코드가 마지막으로 업데이트된 시간을 저장하는 타임스탬프라는 다른 속성이 있으므로 타임스탬프가 아닙니다. 예를 들어 엔터티를 로드하고 업데이트하려는 경우 ETag는 현재 저장된 항목과 일치해야 합니다. 동일한 항목을 편집하는 사용자가 여러 명 있는 경우 서로의 변경 내용을 덮어쓰지 않도록 하려면 적절한 ETag를 설정하는 것이 중요합니다.
content_type
text Blob에 대해 지정된 콘텐츠 형식입니다. 기본 콘텐츠 형식은 .입니다 application/octet-stream.
content_encoding
text Azure Storage에서 정의할 수 있는 Blob의 Content-Encoding 속성입니다. 압축된 콘텐츠의 경우 속성을 Gzip으로 설정할 수 있습니다. 브라우저가 콘텐츠에 액세스하면 콘텐츠의 압축이 자동으로 해제됩니다.
content_hash
text 전송 중에 Blob의 무결성을 확인하는 데 사용되는 해시입니다. 이 헤더를 지정하면 스토리지 서비스는 제공된 해시를 콘텐츠에서 계산된 해시로 확인합니다. 두 해시가 일치하지 않으면 오류 코드 400(잘못된 요청)으로 인해 작업이 실패합니다.
azure_storage.blob_get
데이터를 가져올 수 있는 함수입니다. Azure Storage 계정의 Blob 컨테이너에서 파일을 다운로드합니다. 그런 다음, 콘텐츠를 행으로 변환하여 SQL 언어 구문을 사용하여 사용하고 처리할 수 있습니다. 이 함수는 가져오기 전에 Blob 컨테이너에서 가져온 데이터를 필터링하고 조작하는 지원을 추가합니다.
비고
참조된 스토리지 계정에 대한 컨테이너에 액세스하기 전에 이 함수는 Azure Storage 계정에 적용되는 명명 유효성 검사 규칙에 따라 인수로 전달된 스토리지 계정 및 컨테이너의 이름이 유효한지 확인합니다. 둘 중 하나가 유효하지 않으면 오류가 발생합니다.
azure_storage.blob_get(account_name text, container_name text, path text, decoder text DEFAULT 'auto'::text, compression text DEFAULT 'auto'::text, options jsonb DEFAULT NULL::jsonb);
출력 형식 레코드를 편리하게 정의할 수 있는 매개 변수를 rec 허용하는 이 함수의 오버로드된 버전이 있습니다.
azure_storage.blob_get(account_name text, container_name text, path text, rec anyelement, decoder text DEFAULT 'auto'::text, compression text DEFAULT 'auto'::text, options jsonb DEFAULT NULL::jsonb);
권한
이 함수를 호출하는 사용자 또는 역할은 account_name를 실행하여 참조된 항목의 허용 목록에 추가해야 합니다. 멤버 azure_storage_admin 는 azure_storage.account_add를 사용하여 참조가 추가된 모든 Azure Storage 계정을 자동으로 참조할 수 있습니다.
주장들
account_name
text Blob, 파일, 큐 및 테이블과 같은 모든 개체를 포함하는 Azure Blob Storage 계정의 이름입니다. 스토리지 계정은 HTTPS를 통해 전 세계 어디에서나 액세스할 수 있는 고유한 네임스페이스를 제공합니다.
컨테이너_이름
text 컨테이너의 이름입니다. 컨테이너는 파일 시스템의 디렉터리와 유사한 Blob 집합을 구성합니다. 스토리지 계정에는 무제한의 컨테이너가 포함될 수 있으며 컨테이너는 무제한의 Blob을 저장할 수 있습니다.
컨테이너 이름은 컨테이너 또는 해당 Blob의 주소를 지정하는 데 사용되는 고유한 URI의 일부를 구성하므로 유효한 DNS(도메인 이름 시스템) 이름이어야 합니다.
컨테이너 이름을 지정할 때 는 다음 규칙을 따라야 합니다.
컨테이너의 URI는 다음과 유사합니다. https://myaccount.blob.core.windows.net/mycontainer
길
text Blob의 전체 이름입니다.
rec
anyelement 레코드 출력 구조의 정의입니다.
해독기
text Blob 형식의 사양입니다. 다음 값 중 어느 값으로든 설정할 수 있습니다.
| 형식 | 기본값 | 설명 |
|---|---|---|
auto |
true |
Blob 이름에 할당된 마지막 문자 계열을 기준으로 값을 유추합니다. Blob 이름이 끝나는 .parquetparquet경우 . 또는 .csv다음으로 .csv.gz 끝나는 경우 .를 가정합니다.csv 또는 .tsv다음으로 .tsv.gz 끝나는 경우 .를 가정합니다.tsv 로 끝나는 .json경우 , .json.gz, .xml, .xml.gz.txt또는 .txt.gz, 를 가정합니다.text |
binary |
이진 PostgreSQL COPY 형식입니다. | |
csv |
PostgreSQL COPY에서 사용하는 쉼표로 구분된 값 형식입니다. | |
parquet |
Parquet 형식입니다. | |
text | xml | json |
단일 텍스트 값을 포함하는 파일입니다. | |
tsv |
탭으로 구분된 값, 기본 PostgreSQL COPY 형식입니다. |
압축
text 압축 형식의 사양입니다. 다음 값 중 어느 값으로든 설정할 수 있습니다.
| 형식 | 기본값 | 설명 |
|---|---|---|
auto |
true |
Blob 이름에 할당된 마지막 문자 계열을 기준으로 값을 유추합니다. Blob 이름이 끝나는 .gzgzip경우 . 그렇지 않으면 .none |
brotli |
brotli 압축 알고리즘을 사용하여 Blob을 압축합니다. 인코더에서 parquet 만 지원됩니다. |
|
gzip |
gzip 압축 알고리즘을 사용하여 Blob을 강제로 압축합니다. | |
lz4 |
lz4 압축 알고리즘을 사용하여 Blob을 강제로 압축합니다. 인코더에서 parquet 만 지원됩니다. |
|
none |
강제로 Blob을 압축하지 않습니다. | |
snappy |
스냅 압축 알고리즘을 사용하여 Blob을 압축합니다. 인코더에서 parquet 만 지원됩니다. |
|
zstd |
zstd 압축 알고리즘을 사용하여 Blob을 강제로 압축합니다. 인코더에서 parquet 만 지원됩니다. |
확장은 다른 압축 형식을 지원하지 않습니다.
옵션
jsonb 사용자 지정 헤더, 사용자 지정 구분 기호, 이스케이프 문자 등의 처리를 정의하는 설정입니다. options 는 PostgreSQL에서 명령에 전달할 수 있는 옵션이 해당 동작에 미치는 영향과 유사한 방식으로 이 함수의 COPY 동작에 영향을 줍니다.
반환 형식
SETOF record
SETOF anyelement
azure_storage.blob_put
Azure Storage 계정의 Blob 컨테이너에 파일을 업로드하여 데이터를 내보낼 수 있는 함수입니다. 파일의 내용은 PostgreSQL의 행에서 생성됩니다.
비고
참조된 스토리지 계정에 대한 컨테이너에 액세스하기 전에 이 함수는 Azure Storage 계정에 적용되는 명명 유효성 검사 규칙에 따라 인수로 전달된 스토리지 계정 및 컨테이너의 이름이 유효한지 확인합니다. 둘 중 하나가 유효하지 않으면 오류가 발생합니다.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record)
RETURNS VOID;
매개 변수의 확장 encoder 에서 유추할 수 없거나 유추된 인코더를 재정의할 때 사용할 인코더를 지정할 수 있는 매개 변수를 포함하는 path 오버로드된 버전의 함수가 있습니다.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text)
RETURNS VOID;
매개 변수의 확장 compression 에서 유추할 수 없거나 유추된 매개 변수를 재정의할 때 사용할 압축을 지정할 수 있는 매개 변수도 포함된 path 오버로드된 버전의 함수가 있습니다.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text)
RETURNS VOID;
사용자 지정 헤더, 사용자 지정 구분 기호, 이스케이프 문자 등을 options 처리하기 위한 매개 변수도 포함하는 options 오버로드된 버전의 함수가 PostgreSQL의 명령에 전달할 COPY 수 있는 옵션과 비슷한 방식으로 작동합니다.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text, options jsonb)
RETURNS VOID;
권한
이 함수를 호출하는 사용자 또는 역할은 account_name를 실행하여 참조된 항목의 허용 목록에 추가해야 합니다. 멤버 azure_storage_admin 는 azure_storage.account_add를 사용하여 참조가 추가된 모든 Azure Storage 계정을 자동으로 참조할 수 있습니다.
주장들
account_name
text Blob, 파일, 큐 및 테이블과 같은 모든 개체를 포함하는 Azure Blob Storage 계정의 이름입니다. 스토리지 계정은 HTTPS를 통해 전 세계 어디에서나 액세스할 수 있는 고유한 네임스페이스를 제공합니다.
컨테이너_이름
text 컨테이너의 이름입니다. 컨테이너는 파일 시스템의 디렉터리와 유사한 Blob 집합을 구성합니다. 스토리지 계정에는 무제한의 컨테이너가 포함될 수 있으며 컨테이너는 무제한의 Blob을 저장할 수 있습니다.
컨테이너 이름은 컨테이너 또는 해당 Blob의 주소를 지정하는 데 사용되는 고유한 URI의 일부를 구성하므로 유효한 DNS(도메인 이름 시스템) 이름이어야 합니다.
컨테이너 이름을 지정할 때 는 다음 규칙을 따라야 합니다.
컨테이너의 URI는 다음과 유사합니다. https://myaccount.blob.core.windows.net/mycontainer
길
text Blob의 전체 이름입니다.
튜플
record 레코드 출력 구조의 정의입니다.
인코더
text Blob 형식의 사양입니다. 다음 값 중 어느 값으로든 설정할 수 있습니다.
| 형식 | 기본값 | 설명 |
|---|---|---|
auto |
true |
Blob 이름에 할당된 마지막 문자 계열을 기준으로 값을 유추합니다. Blob 이름이 로 .csv 끝나거나 .csv.gz끝나는 경우 .csv 또는 .tsv다음으로 .tsv.gz 끝나는 경우 .를 가정합니다.tsv 로 끝나는 .json경우 , .json.gz, .xml, .xml.gz.txt또는 .txt.gz, 를 가정합니다.text |
binary |
이진 PostgreSQL COPY 형식입니다. | |
csv |
PostgreSQL COPY에서 사용하는 쉼표로 구분된 값 형식입니다. | |
parquet |
Parquet 형식입니다. | |
text | xml | json |
단일 텍스트 값을 포함하는 파일입니다. | |
tsv |
탭으로 구분된 값, 기본 PostgreSQL COPY 형식입니다. |
압축
text 압축 형식의 사양입니다. 다음 값 중 어느 값으로든 설정할 수 있습니다.
| 형식 | 기본값 | 설명 |
|---|---|---|
auto |
true |
Blob 이름에 할당된 마지막 문자 계열을 기준으로 값을 유추합니다. Blob 이름이 끝나는 .gzgzip경우 . 그렇지 않으면 .none |
brotli |
brotli 압축 알고리즘을 사용하여 Blob을 압축합니다. 인코더에서 parquet 만 지원됩니다. |
|
gzip |
gzip 압축 알고리즘을 사용하여 Blob을 강제로 압축합니다. | |
lz4 |
lz4 압축 알고리즘을 사용하여 Blob을 강제로 압축합니다. 인코더에서 parquet 만 지원됩니다. |
|
none |
강제로 Blob을 압축하지 않습니다. | |
snappy |
스냅 압축 알고리즘을 사용하여 Blob을 압축합니다. 인코더에서 parquet 만 지원됩니다. |
|
zstd |
zstd 압축 알고리즘을 사용하여 Blob을 강제로 압축합니다. 인코더에서 parquet 만 지원됩니다. |
확장은 다른 압축 형식을 지원하지 않습니다.
옵션
jsonb 사용자 지정 헤더, 사용자 지정 구분 기호, 이스케이프 문자 등의 처리를 정의하는 설정입니다. options 는 PostgreSQL에서 명령에 전달할 수 있는 옵션이 해당 동작에 미치는 영향과 유사한 방식으로 이 함수의 COPY 동작에 영향을 줍니다.
반환 형식
VOID
azure_storage.options_copy
유틸리티 함수 역할을 하는 함수이며, 이 함수는 내에서 blob_get매개 변수로 호출될 수 있습니다.
options_parquet, options_csv_get, options_tsv및options_binary 도우미 함수로 작동합니다.
azure_storage.options_copy(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, header boolean DEFAULT NULL::boolean, quote text DEFAULT NULL::text, escape text DEFAULT NULL::text, force_quote text[] DEFAULT NULL::text[], force_not_null text[] DEFAULT NULL::text[], force_null text[] DEFAULT NULL::text[], content_encoding text DEFAULT NULL::text);
권한
모든 사용자 또는 역할은 이 함수를 호출할 수 있습니다.
주장들
구분자
text 파일의 각 행(줄) 내에서 열을 구분하는 문자입니다. 단일 1 바이트 문자여야 합니다. 이 함수는 임의의 수의 문자 구분 기호를 지원하지만 1 바이트 이상의 문자를 사용하려고 하면 PostgreSQL에서 오류를 다시 COPY delimiter must be a single one-byte character 보고합니다.
null_string
text null 값을 나타내는 문자열입니다. 기본값은 텍스트 형식의 \N(backslash-N)이며 CSV 형식의 따옴표가 지정되지 않은 빈 문자열입니다. 빈 문자열과 null을 구분하지 않으려는 경우 텍스트 형식에서도 빈 문자열을 사용하는 것이 좋습니다.
머리글
boolean 파일에 파일의 각 열 이름이 포함된 헤더 줄이 포함되어 있는지를 나타내는 플래그입니다. 출력 시 초기 줄에는 테이블의 열 이름이 포함됩니다.
견적
text 데이터 값을 따옴표로 묶을 때 사용할 따옴표 문자입니다. 기본값은 큰따옴표입니다. 단일 1 바이트 문자여야 합니다. 이 함수는 임의의 수의 문자 구분 기호를 지원하지만 1 바이트 이상의 문자를 사용하려고 하면 PostgreSQL에서 오류를 다시 COPY quote must be a single one-byte character 보고합니다.
탈출
text QUOTE 값과 일치하는 데이터 문자 앞에 표시되어야 하는 문자입니다. 기본값은 QUOTE 값과 동일합니다(따옴표 문자가 데이터에 표시되면 두 배가 되도록). 단일 1 바이트 문자여야 합니다. 이 함수는 임의의 수의 문자 구분 기호를 지원하지만 1 바이트 이상의 문자를 사용하려고 하면 PostgreSQL에서 오류를 다시 COPY escape must be a single one-byte character 보고합니다.
force_quote
text[] 지정된 각 열의 NULL이 아닌 모든 값에 따옴표를 사용합니다. NULL 출력은 따옴표로 묶지 않습니다. *를 지정하면 NULL이 아닌 값이 모든 열에서 따옴표로 묶입니다.
force_not_null
text[] 지정된 열의 값과 null 문자열을 일치하지 않습니다. null 문자열이 비어 있는 기본 경우 빈 값은 따옴표가 붙지 않더라도 null이 아닌 길이가 0인 문자열로 읽혀집니다.
force_null
text[] 따옴표로 묶어도 지정된 열의 값을 null 문자열과 일치시키고 일치 항목이 발견되면 값을 NULL로 설정합니다. null 문자열이 비어 있는 기본 경우 따옴표 붙은 빈 문자열을 NULL로 변환합니다.
content_encoding
text 파일이 인코딩되는 인코딩의 이름입니다. 옵션을 생략하면 현재 클라이언트 인코딩이 사용됩니다.
반환 형식
jsonb
azure_storage.options_parquet
유틸리티 함수 역할을 하는 함수이며, 이 함수는 내에서 blob_get매개 변수로 호출될 수 있으며 parquet 파일의 콘텐츠를 디코딩하는 데 유용합니다.
azure_storage.options_parquet();
권한
모든 사용자 또는 역할은 이 함수를 호출할 수 있습니다.
주장들
반환 형식
jsonb
azure_storage.options_csv_get
유틸리티 함수 역할을 하는 함수이며, 이 함수는 내에서 blob_get매개 변수로 호출될 수 있으며 csv 파일의 콘텐츠를 디코딩하는 데 유용합니다.
azure_storage.options_csv_get(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, header boolean DEFAULT NULL::boolean, quote text DEFAULT NULL::text, escape text DEFAULT NULL::text, force_not_null text[] DEFAULT NULL::text[], force_null text[] DEFAULT NULL::text[], content_encoding text DEFAULT NULL::text);
권한
모든 사용자 또는 역할은 이 함수를 호출할 수 있습니다.
주장들
구분자
text 파일의 각 행(줄) 내에서 열을 구분하는 문자입니다. 단일 1 바이트 문자여야 합니다. 이 함수는 임의의 수의 문자 구분 기호를 지원하지만 1 바이트 이상의 문자를 사용하려고 하면 PostgreSQL에서 오류를 다시 COPY delimiter must be a single one-byte character 보고합니다.
null_string
text null 값을 나타내는 문자열입니다. 기본값은 텍스트 형식의 \N(backslash-N)이며 CSV 형식의 따옴표가 지정되지 않은 빈 문자열입니다. 빈 문자열과 null을 구분하지 않으려는 경우 텍스트 형식에서도 빈 문자열을 사용하는 것이 좋습니다.
머리글
boolean 파일에 파일의 각 열 이름이 포함된 헤더 줄이 포함되어 있는지를 나타내는 플래그입니다. 출력 시 초기 줄에는 테이블의 열 이름이 포함됩니다.
견적
text 데이터 값을 따옴표로 묶을 때 사용할 따옴표 문자입니다. 기본값은 큰따옴표입니다. 단일 1 바이트 문자여야 합니다. 이 함수는 임의의 수의 문자 구분 기호를 지원하지만 1 바이트 이상의 문자를 사용하려고 하면 PostgreSQL에서 오류를 다시 COPY quote must be a single one-byte character 보고합니다.
탈출
text QUOTE 값과 일치하는 데이터 문자 앞에 표시되어야 하는 문자입니다. 기본값은 QUOTE 값과 동일합니다(따옴표 문자가 데이터에 표시되면 두 배가 되도록). 단일 1 바이트 문자여야 합니다. 이 함수는 임의의 수의 문자 구분 기호를 지원하지만 1 바이트 이상의 문자를 사용하려고 하면 PostgreSQL에서 오류를 다시 COPY escape must be a single one-byte character 보고합니다.
force_not_null
text[] 지정된 열의 값과 null 문자열을 일치하지 않습니다. null 문자열이 비어 있는 기본 경우 빈 값은 따옴표가 붙지 않더라도 null이 아닌 길이가 0인 문자열로 읽혀집니다.
force_null
text[] 따옴표로 묶어도 지정된 열의 값을 null 문자열과 일치시키고 일치 항목이 발견되면 값을 NULL로 설정합니다. null 문자열이 비어 있는 기본 경우 따옴표 붙은 빈 문자열을 NULL로 변환합니다.
content_encoding
text 파일이 인코딩되는 인코딩의 이름입니다. 옵션을 생략하면 현재 클라이언트 인코딩이 사용됩니다.
반환 형식
jsonb
azure_storage.options_tsv
유틸리티 함수 역할을 하는 함수이며, 이 함수는 내에서 blob_get매개 변수로 호출할 수 있으며 tsv 파일의 콘텐츠를 디코딩하는 데 유용합니다.
azure_storage.options_tsv(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, content_encoding text DEFAULT NULL::text);
권한
모든 사용자 또는 역할은 이 함수를 호출할 수 있습니다.
주장들
구분자
text 파일의 각 행(줄) 내에서 열을 구분하는 문자입니다. 단일 1 바이트 문자여야 합니다. 이 함수는 임의의 수의 문자 구분 기호를 지원하지만 1 바이트 이상의 문자를 사용하려고 하면 PostgreSQL에서 오류를 다시 COPY delimiter must be a single one-byte character 보고합니다.
null_string
text null 값을 나타내는 문자열입니다. 기본값은 텍스트 형식의 \N(backslash-N)이며 CSV 형식의 따옴표가 지정되지 않은 빈 문자열입니다. 빈 문자열과 null을 구분하지 않으려는 경우 텍스트 형식에서도 빈 문자열을 사용하는 것이 좋습니다.
content_encoding
text 파일이 인코딩되는 인코딩의 이름입니다. 옵션을 생략하면 현재 클라이언트 인코딩이 사용됩니다.
반환 형식
jsonb
azure_storage.options_binary
유틸리티 함수 역할을 하는 함수이며, 이 함수 내에서 blob_get매개 변수로 호출할 수 있으며 이진 파일의 콘텐츠를 디코딩하는 데 유용합니다.
azure_storage.options_binary(content_encoding text DEFAULT NULL::text);
권한
모든 사용자 또는 역할은 이 함수를 호출할 수 있습니다.
주장들
content_encoding
text 파일이 인코딩되는 인코딩의 이름입니다. 옵션을 생략하면 현재 클라이언트 인코딩이 사용됩니다.
반환 형식
jsonb