CREATE ORGANIZATION PROFILE

CREATE ORGANIZATION PROFILE

ULL(Uniform Listing Locator)의 일부를 구성하는 조직 프로필(organization profile)을 만드는 명령이에요. 조직 프로필은 조직 리스팅을 게시하거나, 리스팅을 마운트하지 않고 조직 리스팅 정보를 쿼리하는 데 사용돼요.

출처: 문서

본문

ULL(Uniform Listing Locator)의 일부를 구성하는 조직 프로필을 만들어요. 조직 프로필은 조직 리스팅을 게시하거나, 리스팅을 마운트하지 않고 조직 리스팅 정보를 쿼리하는 데 사용돼요. 조직 프로필을 만들려면 리스팅 매니페스트를 수정한 뒤 게시하거나 게시 취소할 수 있는 스테이지로 옮겨요.

함께 보기: ALTER ORGANIZATION PROFILE, DESCRIBE AVAILABLE ORGANIZATION PROFILE, DESCRIBE ORGANIZATION PROFILE, DROP ORGANIZATION PROFILE, SHOW AVAILABLE ORGANIZATION PROFILES, SHOW ORGANIZATION PROFILES, SHOW VERSIONS IN ORGANIZATION PROFILE, 조직 프로필 매니페스트 참조(Organization profile manifest reference)

구문 (Syntax)

CREATE ORGANIZATION PROFILE [ IF NOT EXISTS ] <name>

CREATE ORGANIZATION PROFILE [ IF NOT EXISTS ] <name>
  AS '<yaml_manifest_string>'
  [ VERSION <version_alias_name> ]
  [ PUBLISH = { TRUE | FALSE } ]

CREATE ORGANIZATION PROFILE [ IF NOT EXISTS ] <name>
  FROM @<yaml_manifest_stage_location>
  [ VERSION <version_alias_name> ]
  [ PUBLISH = { TRUE | FALSE } ]

필수 매개변수 (Required parameters)

name 조직 프로필의 식별자(이름)를 지정하는 문자열로, 현재 조직 안에서 고유해야 해요. 식별자는 Snowflake 식별자 요구 사항을 따라야 해요. 식별자 요구 사항(Identifier requirements)을 참고해요. 또한 조직 프로필 이름은 대문자 또는 숫자만 포함할 수 있고, 대문자로 시작해야 하며, 길이가 128자를 초과할 수 없어요.

AS 'yaml_manifest_string' 조직 프로필의 YAML 매니페스트를 지정해요. 조직 리스팅 프로필 매니페스트 필드는 조직 프로필 매니페스트 참조(Organization profile manifest reference)를 참고해요.

인라인 매니페스트는 일반적으로 달러 기호 인용 문자열로 제공돼요. 자세한 내용은 달러 기호 인용 문자열 상수(Dollar-quoted string constants)를 참고해요.

FROM @yaml_manifest_stage_location 외부 스테이지, 내부 스테이지 또는 Git 저장소 클론의 YAML 형식 매니페스트 스테이지 위치를 지정해요.

선택 매개변수 (Optional parameters)

VERSION version_alias_name 선택 사항이에요. 추가되는 버전의 고유 버전 식별자를 지정해요. VERSION version_name을 지정하지 않으면 별칭이 만들어지지 않아요. 식별자에 공백·특수 문자·혼합 대소문자가 포함되면 전체 식별자를 큰따옴표로 감싸야 해요. 큰따옴표로 묶인 식별자는 대소문자를 구분해요. FIRST, LAST, DEFAULT 또는 LIVE 키워드는 버전 바로 가기로 예약되어 있어 사용할 수 없어요. 고유 버전 식별자는 "version$"로 시작할 수 없고 슬래시(/)를 포함할 수 없어요. 식별자 구문에 대한 정보는 식별자 요구 사항(Identifier requirements)을 참고해요.

PUBLISH = { TRUE | FALSE } 선택 사항이에요. 조직 프로필을 게시하는 방법을 지정해요.

  • TRUE이면 조직 프로필이 즉시 게시돼요.
  • 기본값: FALSE

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

이 작업을 실행하는 데 사용하는 역할(role)은 최소한 다음 권한을 가져야 해요.

권한 (Privilege) 객체 (Object) 비고
CREATE ORGANIZATION PROFILE Account 조직 프로필은 조직의 조직 계정에서만 만들 수 있어요. GLOBALORGADMIN 역할에 CREATE ORGANIZATION PROFILE 권한이 부여되어 있어요.

사용 메모 (Usage notes)

CREATE ORGANIZATION PROFILE로 만든 조직 프로필은 게시될 때까지 DRAFT 상태예요.

조직 프로필 매니페스트의 사용 예시는 조직 리스팅 관리(Manage organizational listings)를 참고해요.

예시 (Examples)

이 예시는 OrgProfileDB라는 데이터베이스, my_test_state_org_profile이라는 스테이지, 그리고 MY_ORG_PROFILE이라는 제목의 조직 프로필을 만들어요. title 필드는 공급자 도메인(provider domain)을 나타내며, 조직 리스팅 아래와 내부 마켓플레이스의 Providers 아래 필터 옵션으로 표시돼요.

CREATE DATABASE OrgProfileDB;
CREATE STAGE my_test_stage_org_profile;
COPY INTO @my_test_stage_org_profile/manifest.yml
  FROM (
    SELECT $$
      title: "MY_ORG_PROFILE"
      description: "Profile for SE Business Unit"
      contact: "[email protected]"
      approver_contact: "[email protected]"
      allowed_publishers:
        access:
          - all_internal_accounts: "true"
      logo: "urn:icon:shieldlock:blue"
    $$
  )
  SINGLE = TRUE
  OVERWRITE = TRUE
  FILE_FORMAT = (
    COMPRESSION = NONE
    ESCAPE_UNENCLOSED_FIELD = NONE
  );

이 예시는 my_test_stage_org_profile 스테이지에서 MYPROFILENAME이라는 조직 프로필을 게시해요.

CREATE ORGANIZATION PROFILE MYPROFILENAME
 FROM @my_test_stage_org_profile
 PUBLISH=TRUE;

더 알아보기 (Learn more)