ALTER ACCOUNT

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

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

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

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

    • 리소스 모니터

    • 태그

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

  • 계정의 이름을 바꾸고, 원래 URL을 사용하여 계정에 액세스할 수 있는지 여부를 지정하기 위한 조직 관리자(즉, ORGADMIN 역할이 있는 사용자).

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

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

매개 변수 섹션을 참조하십시오.

구문

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

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

ALTER ACCOUNT SET RESOURCE_MONITOR = <monitor_name>

ALTER ACCOUNT SET { PASSWORD | SESSION } POLICY = '<string_literal>'

ALTER ACCOUNT UNSET { PASSWORD | SESSION } POLICY

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

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

ALTER ACCOUNT <account_name> RENAME TO <new_account_name> [ SAVE_OLD_URL = { TRUE | FALSE } ]

ALTER ACCOUNT <account_name> DROP OLD URL
Copy

여기서:

accountParams ::=
    ALLOW_ID_TOKEN = TRUE | FALSE
    CLIENT_ENCRYPTION_KEY_SIZE = <integer>
    ENABLE_INTERNAL_STAGES_PRIVATELINK = 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
userParams ::=
    ENABLE_UNREDACTED_QUERY_SYNTAX_ERROR = TRUE | FALSE
Copy
objectParams ::=
    DATA_RETENTION_TIME_IN_DAYS = <integer>
    MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer>
    DEFAULT_DDL_COLLATION = '<collation_specification>'
    MAX_CONCURRENCY_LEVEL = <num>
    NETWORK_POLICY = <string>
    PASSWORD 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>
    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

참고

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

매개 변수

SET ...

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

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

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

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

UNSET ...

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

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

SET RESOURCE_MONITOR resource_monitor_name

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

중요

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

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

PASSWORD POLICY 'password_policy_name'

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

SESSION POLICY session_policy_name

계정에 대해 설정할 세션 정책 을 지정합니다.

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

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

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

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

RENAME TO new_account_name

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

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

SAVE_OLD_URL

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

기본값

TRUE

DROP OLD URL

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

사용법 노트

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

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

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

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

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

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

  • 메타데이터 관련:

    주의

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

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

ALTER ACCOUNT SET NETWORK_POLICY = mypolicy;
Copy

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

ALTER ACCOUNT UNSET NETWORK_POLICY;
Copy