ALTER ACCOUNT

계정을 수정합니다. 계정 수준에서 모든 유형의 매개 변수(계정, 세션 또는 오브젝트)를 수정하는 데 사용할 수 있습니다. 또한 계정 이름을 바꾸고 리소스 모니터와 태그를 계정에 할당하는 데 사용됩니다. 이 명령은 다음을 통해서만 실행할 수 있습니다.

  • 설정 및 설정 해제할 계정 관리자(즉, ACCOUNTADMIN 역할이 있는 사용자):

    • 다른 사용자가 변경할 수 없는 계정 매개 변수.

    • 사용자, 세션 및 관련 오브젝트에 대한 매개 변수 기본값으로 사용되는 세션 및 오브젝트 매개 변수. 이러한 기본값은 언제든지 재정의할 수 있습니다.

    • 리소스 모니터

    • 태그

  • NETWORK_POLICY 계정 매개 변수를 설정 및 설정 해제하기 위한 보안 관리자(즉, SECURITYADMIN 역할이 있는 사용자) 또는 더 상위의 역할.

  • 다음 작업을 수행하는 조직 관리자(즉, ORGADMIN 역할이 있는 사용자).

    • 계정의 이름을 바꾸고 원래 URL을 사용하여 계정에 액세스할 수 있는지 여부를 지정합니다.

    • 계정에서 ORGADMIN 역할을 활성화합니다.

계정에서 생성된 모든 가상 웨어하우스에 대한 크레딧 사용을 제어하기 위한 리소스 모니터 를 지정하는 데 사용할 수도 있습니다.

계정 수준에서 매개 변수 설정에 대한 자세한 내용은 매개 변수 관리 를 참조하십시오. 매개 변수 세부 정보는 매개 변수 를 참조하십시오.

구문

ALTER ACCOUNT의 구문은 현재 계정 또는 다른 계정을 수정하는지에 따라 달라집니다.

현재 계좌 변경하기

ALTER ACCOUNT SET { [ accountParams ] [ objectParams ] [ sessionParams ] }

ALTER ACCOUNT UNSET <param_name> [ , ... ]

ALTER ACCOUNT SET RESOURCE_MONITOR = <monitor_name>

ALTER ACCOUNT SET { PASSWORD | SESSION } POLICY <policy_name>

ALTER ACCOUNT SET PACKAGES POLICY <policy_name> [ FORCE ]

ALTER ACCOUNT UNSET { PACKAGES | PASSWORD | SESSION } POLICY

ALTER ACCOUNT SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER ACCOUNT UNSET TAG <tag_name> [ , <tag_name> ... ]
Copy

여기서:

accountParams ::=
    ALLOW_ID_TOKEN = TRUE | FALSE
    CLIENT_ENCRYPTION_KEY_SIZE = <integer>
    ENABLE_INTERNAL_STAGES_PRIVATELINK = TRUE | FALSE
    ENFORCE_NETWORK_RULES_FOR_INTERNAL_STAGES = TRUE | FALSE
    EXTERNAL_OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST = TRUE | FALSE
    INITIAL_REPLICATION_SIZE_LIMIT_IN_TB = <num>
    NETWORK_POLICY = <string>
    PERIODIC_DATA_REKEYING = TRUE | FALSE
    PREVENT_UNLOAD_TO_INLINE_URL = TRUE | FALSE
    PREVENT_UNLOAD_TO_INTERNAL_STAGES = TRUE | FALSE
    REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_CREATION = TRUE | FALSE
    REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_OPERATION = TRUE | FALSE
    SAML_IDENTITY_PROVIDER = <json_object>
    SSO_LOGIN_PAGE = TRUE | FALSE
Copy
objectParams ::=
    DATA_RETENTION_TIME_IN_DAYS = <integer>
    ENABLE_UNREDACTED_QUERY_SYNTAX_ERROR = TRUE | FALSE
    MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer>
    DEFAULT_DDL_COLLATION = '<collation_specification>'
    MAX_CONCURRENCY_LEVEL = <num>
    NETWORK_POLICY = <string>
    PIPE_EXECUTION_PAUSED = TRUE | FALSE
    STATEMENT_QUEUED_TIMEOUT_IN_SECONDS = <num>
    STATEMENT_TIMEOUT_IN_SECONDS = <num>
Copy
sessionParams ::=
    ABORT_DETACHED_QUERY = TRUE | FALSE
    AUTOCOMMIT = TRUE | FALSE
    BINARY_INPUT_FORMAT = <string>
    BINARY_OUTPUT_FORMAT = <string>
    DATE_INPUT_FORMAT = <string>
    DATE_OUTPUT_FORMAT = <string>
    ERROR_ON_NONDETERMINISTIC_MERGE = TRUE | FALSE
    ERROR_ON_NONDETERMINISTIC_UPDATE = TRUE | FALSE
    JSON_INDENT = <num>
    LOCK_TIMEOUT = <num>
    QUERY_TAG = <string>
    ROWS_PER_RESULTSET = <num>
    S3_STAGE_VPCE_DNS_NAME = <string>
    SEARCH_PATH = <string>
    SIMULATED_DATA_SHARING_CONSUMER = <string>
    STATEMENT_TIMEOUT_IN_SECONDS = <num>
    STRICT_JSON_OUTPUT = TRUE | FALSE
    TIMESTAMP_DAY_IS_ALWAYS_24H = TRUE | FALSE
    TIMESTAMP_INPUT_FORMAT = <string>
    TIMESTAMP_LTZ_OUTPUT_FORMAT = <string>
    TIMESTAMP_NTZ_OUTPUT_FORMAT = <string>
    TIMESTAMP_OUTPUT_FORMAT = <string>
    TIMESTAMP_TYPE_MAPPING = <string>
    TIMESTAMP_TZ_OUTPUT_FORMAT = <string>
    TIMEZONE = <string>
    TIME_INPUT_FORMAT = <string>
    TIME_OUTPUT_FORMAT = <string>
    TRANSACTION_DEFAULT_ISOLATION_LEVEL = <string>
    TWO_DIGIT_CENTURY_START = <num>
    UNSUPPORTED_DDL_ACTION = <string>
    USE_CACHED_RESULT = TRUE | FALSE
    WEEK_OF_YEAR_POLICY = <num>
    WEEK_START = <num>
Copy

참고

가독성을 위해 계정에 대해 설정할 수 있는 세션 매개 변수의 전체 목록은 여기에 포함되지 않습니다. 계정 및 오브젝트 매개 변수뿐 아니라 설명을 포함한 모든 세션 매개 변수의 전체 목록은 매개 변수 를 참조하십시오.

다른 계정 변경하기

ALTER ACCOUNT <name> SET IS_ORG_ADMIN = { TRUE | FALSE }

ALTER ACCOUNT <name> RENAME TO <new_name> [ SAVE_OLD_URL = { TRUE | FALSE } ]

ALTER ACCOUNT <name> DROP OLD URL

ALTER ACCOUNT <name> DROP OLD ORGANIZATION URL
Copy

현재 계정을 변경하기 위한 매개 변수

현재 계정을 수정할 때 다음 매개 변수를 사용하십시오.

SET ...

계정에 대해 설정할 하나 이상의 계정, 세션 및 오브젝트 매개 변수를 지정합니다(공백, 쉼표 또는 줄 바꿈으로 구분됨).

  • 계정 매개 변수는 다른 사용자가 변경할 수 없습니다.

  • 계정 수준에서 설정한 세션 및 오브젝트 매개 변수는 기본값으로만 사용되며 다른 사용자가 이를 변경할 수 있습니다.

계정에 대해 설정할 수 있는 매개 변수에 대한 설명은 매개 변수 를 참조하십시오.

UNSET ...

계정에 대해 설정 해제할 하나 이상의 계정, 세션 및 오브젝트 매개 변수를 지정하여 이들 매개 변수를 시스템 기본값으로 재설정합니다.

단일 ALTER 문으로 여러 속성을 재설정할 수 있지만, 각 속성은 쉼표로 구분해야 합니다. 속성을 재설정할 때는 이름만 지정하십시오. 속성 값을 지정하면 오류가 반환됩니다.

SET RESOURCE_MONITOR resource_monitor_name

계정에서 생성된 모든 가상 웨어하우스를 제어하는 데 사용되는 리소스 모니터의 이름을 지정하는 특수한 매개 변수입니다.

중요

계정 수준에서 리소스 모니터를 설정해도 Snowflake가 Snowpipe, 자동 재클러스터링 또는 구체화된 뷰에 사용하는 Snowflake 제공 웨어하우스에는 전혀 영향을 미치지 않습니다. 이러한 웨어하우스에서 소비한 크레딧은 계정 수준 리소스 모니터의 크레딧 할당량에는 계산되지 않습니다.

자세한 내용은 리소스 모니터 관련 작업하기 섹션을 참조하십시오.

SET { PASSWORD | SESSION } POLICY policy_name

계정에 대해 설정할 비밀번호 정책 또는 세션 정책 을 지정합니다.

SET PACKAGES POLICY policy_name [ FORCE ]

계정에 대해 설정할 패키지 정책 을 지정합니다. 현재 계정에 패키지 정책이 이미 설정되어 있는 경우 먼저 패키지 정책을 설정 해제하지 않고도 FORCE를 사용하여 패키지 정책을 설정할 수 있습니다.

UNSET { PACKAGES | PASSWORD | SESSION } POLICY

계정에 대한 패키지 정책, 비밀번호 정책 또는 세션 정책을 설정 해제합니다.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

태그 이름과 태그 문자열 값을 지정합니다.

태그 값은 항상 문자열이며, 태그 값의 최대 문자 수는 256자입니다.

문에서 태그를 지정하는 방법에 대한 자세한 내용은 오브젝트 및 열에 대한 태그 할당량 섹션을 참조하십시오.

다른 계정을 변경하기 위한 매개 변수

현재 계정을 사용하여 다른 계정을 수정할 때 다음 매개 변수를 사용하십시오. 조직 관리자(즉, ORGADMIN 역할이 있는 사용자)만 다음 매개 변수를 사용할 수 있습니다.

name

수정 중인 계정의 이름을 지정합니다.

SET

계정에 대해 설정할 계정 속성을 지정합니다.

IS_ORG_ADMIN = { TRUE | FALSE }

계정에서 ORGADMIN 역할이 활성화되었는지 여부를 결정하는 계정 속성을 설정합니다. 조직 관리자(즉, ORGADMIN 역할이 있는 사용자)만 속성을 설정할 수 있습니다.

계정에 대해 ORGADMIN 역할을 활성화하려면 SET IS_ORG_ADMIN = TRUE 를 지정하십시오.

현재 계정에서는 속성을 FALSE 로 설정할 수 없습니다. 이 문제를 해결하려면 다른 계정에서 역할을 활성화한 다음 해당 계정으로 전환한 후 ALTER ACCOUNT 명령을 실행하십시오.

기본적으로, 최대 8개의 계정에서 ORGADMIN 역할을 활성화할 수 있습니다. 조직에 ORGADMIN 역할이 있는 계정이 더 필요한 경우 Snowflake 지원 에 문의하십시오.

RENAME TO new_name

계정 이름을 지정된 이름으로 변경합니다.

조직 관리자는 자신이 로그인되어 있는 동안 계정의 이름을 바꿀 수 없으므로, ALTER ACCOUNT 명령을 실행하기 전에 다른 계정으로 로그인해야 합니다. 조직이 이름을 바꿔야 하는 단일 계정으로 구성된 경우 Snowflake 지원 에 문의하십시오.

SAVE_OLD_URL = { TRUE | FALSE }

이름 변경 전에 Snowflake에 액세스하는 데 사용되는 계정 URL 을 유지하는 RENAME TO 과 함께 사용되는 선택적 매개 변수. 기본적으로 Snowflake는 원래 URL을 저장합니다. 즉, 이전 URL이나, 새 계정 이름이 포함된 URL로 계정에 액세스할 수 있습니다. FALSE 로 설정하면 새 URL을 사용하여 계정에 액세스해야 합니다.

기본값

TRUE

DROP OLD URL

이름이 바뀐 계정의 원래 계정 URL 을 제거합니다. 이전 URL이 삭제되면, 새 계정 이름이 포함된 URL로 계정에 액세스해야 합니다.

계정이 다른 조직으로 이동되었거나 조직 이름이 바뀌었거나 합병된 조직에 포함되어 이전 계정 URL이 있는 경우 ALTER ACCOUNT … DROP OLD ORGANIZATION URL을 대신 사용하십시오.

DROP OLD ORGANIZATION URL

다음 중 하나가 발생한 후 계정의 원래 계정 URL 을 제거합니다.

  • 계정이 다른 조직으로 이동됨

  • 계정의 조직 이름이 바뀜

  • 계정이 다른 조직과 합병된 조직의 일부로 포함됨

조직이 아닌 계정 이름이 바뀌어 계정에 이전 계정 URL이 있는 경우 ALTER ACCOUNT … DROP OLD URL 명령을 대신 사용하십시오.

사용법 노트

  • 계정 매개 변수는 계정 수준에서만 설정할 수 있습니다.

  • 이 명령을 사용하여 설정한 세션 및 오브젝트 매개 변수는 기본값으로만 사용됩니다.

    • 사용자 매개 변수는 개별 사용자 수준에서 재정의할 수 있습니다.

    • 세션 매개 변수는 개별 사용자 및 세션 수준에서 재정의할 수 있습니다.

    • 오브젝트 매개 변수는 개별 오브젝트 수준에서 재정의할 수 있습니다.

  • 계정 수준에서 리소스 모니터를 설정하여 계정에서 생성된 모든 가상 웨어하우스의 크레딧 사용을 제어할 수 있지만, Snowflake 제공 웨어하우스의 크레딧 사용에는 영향을 미치지 않습니다. 자세한 내용은 리소스 모니터 관련 작업하기 섹션을 참조하십시오.

  • 메타데이터 관련:

    주의

    고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.

mypolicy 로 명명된 네트워크 정책을 계정과 연결합니다.

ALTER ACCOUNT SET NETWORK_POLICY = mypolicy;
Copy

계정에서 네트워크 정책 연결을 제거합니다.

ALTER ACCOUNT UNSET NETWORK_POLICY;
Copy

계정 수준에서 패키지 정책을 설정합니다.

ALTER ACCOUNT SET PACKAGES POLICY packages_policy_prod_1 FORCE;
Copy

참고

현재 계정에 패키지 정책이 이미 설정되어 있는 경우 먼저 패키지 정책을 설정 해제하지 않고도 FORCE를 사용하여 패키지 정책을 설정할 수 있습니다.

패키지 정책을 설정 해제합니다.

ALTER ACCOUNT UNSET PACKAGES POLICY;
Copy