CREATE STORAGE INTEGRATION

CREATE STORAGE INTEGRATION (Postgres Internal Storage)

CREATE STORAGE INTEGRATION (Postgres Internal Storage) 명령은 Postgres 내부 스토리지에 대한 새 스토리지 통합을 만들거나 기존 통합을 교체하는 명령이에요. Snowflake Postgres 인스턴스와 연결된 관리형 스토리지에 접근하는 데 사용됩니다.

출처: CREATE STORAGE INTEGRATION (Postgres Internal Storage)

본문

Postgres 내부 스토리지에 대한 새 스토리지 통합을 만들거나 기존 통합을 교체하는 명령입니다. Preview Feature — Open — 모든 계정에서 사용할 수 있어요. 이 통합은 Snowflake Postgres 인스턴스와 연결된 관리형 스토리지에 접근하는 데 사용됩니다. POSTGRES_EXTERNAL_STORAGE 유형(자체 S3 버킷과 IAM 역할을 제공해야 하는)과 달리 POSTGRES_INTERNAL_STORAGE 통합은 Postgres 인스턴스가 자동으로 할당하는 관리형 스토리지를 사용해요.

Syntax

CREATE [ OR REPLACE ] STORAGE INTEGRATION [ IF NOT EXISTS ] <name>
  TYPE = POSTGRES_INTERNAL_STORAGE
  POSTGRES_INSTANCE = '<instance_name>'
  [ ENABLED = { TRUE | FALSE } ]
  [ COMMENT = '<string_literal>' ]

Parameters (파라미터)

name — 스토리지 통합의 식별자(이름)를 지정하는 문자열이에요. 계정 내에서 고유해야 합니다. 또한 식별자는 알파벳 문자로 시작해야 하고, 전체 식별자 문자열을 큰따옴표로 감싸지 않는 한 공백이나 특수 문자를 포함할 수 없어요 (예: "My object"). 큰따옴표로 감싼 식별자는 대소문자를 구분합니다. 자세한 내용은 Identifier requirements 문서를 참고하세요.
TYPE = POSTGRES_INTERNAL_STORAGE — 통합 유형이 Postgres 관리(내부) 스토리지용임을 지정해요.
POSTGRES_INSTANCE = '<instance_name>' — Snowflake Postgres 인스턴스의 이름을 지정해요. 필수입니다. Postgres 인스턴스는 READY 상태여야 합니다. Postgres 인스턴스를 만들려면 CREATE POSTGRES INSTANCE 문서를 참고하세요.
ENABLED = { TRUE | FALSE } — 이 스토리지 통합을 스테이지에서 사용할 수 있는지 여부를 지정해요. 값은 대소문자를 구분하지 않습니다. 기본값: TRUE
COMMENT = '<string_literal>' — 통합에 대한 주석을 지정하는 문자열(리터럴)이에요. 기본값: 값 없음

Access control requirements (접근 제어 요구 사항)

이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 보유해야 해요.

지정된 권한 집합으로 사용자 정의 역할을 만드는 방법은 Creating custom roles 문서를, 보안 객체에 대한 SQL 작업의 역할·권한 부여에 대한 일반적인 정보는 Overview of Access Control 문서를 참고하세요.

Examples (예제)

다음 예제는 Postgres 내부 스토리지에 대한 스토리지 통합을 만들어요. ENABLED 파라미터는 기본값 TRUE이므로 생략되었습니다.

CREATE STORAGE INTEGRATION postgres_internal
  TYPE = POSTGRES_INTERNAL_STORAGE
  POSTGRES_INSTANCE = 'my_pg_instance';

CREATE STORAGE INTEGRATION