SHOW PARAMETERS¶
설정할 수 있는 모든 계정, 세션 및 오브젝트 매개 변수뿐 아니라, 각 매개 변수의 현재 값과 기본값도 나열합니다.
계정 매개 변수는 계정 수준에서만 설정할 수 있습니다.
세션 매개 변수는 계정, 사용자 및 세션 수준에서 설정할 수 있습니다.
오브젝트 매개 변수는 계정 및 오브젝트 수준에서 설정할 수 있습니다.
매개 변수를 명시적으로 설정한 경우 이 명령의 출력에는 매개 변수를 설정한 수준도 표시됩니다.
다양한 매개 변수 유형에 대한 설명과 각 매개 변수에 대한 자세한 설명은 매개 변수 를 참조하십시오.
구문¶
SHOW PARAMETERS [ LIKE '<pattern>' ]
[ { IN | FOR } { SESSION | ACCOUNT | USER [ <name> ] | { WAREHOUSE | DATABASE | SCHEMA | TASK } [ <name> ] | TABLE <table_name> } ]
매개 변수¶
LIKE 'pattern'오브젝트 이름으로 명령 출력을 선택적으로 필터링합니다. 이 필터는 SQL 와일드카드 문자(
%및_) 지원과 함께 대/소문자를 구분하지 않는 패턴 일치를 사용합니다.예를 들어, 다음 패턴은 같은 결과를 반환합니다.
... LIKE '%testing%' ...... LIKE '%TESTING%' .... 기본값: 값 없음(출력에 필터링이 적용되지 않음).
IN | FORIN ...또는FOR ...는 명령의 범위를 지정하며, 이를 통해 반환되는 매개 변수가 결정됩니다.SESSION현재 세션에 대한 모든 세션 매개 변수와 이들의 설정을 반환합니다. 사용자는 ALTER SESSION 을 사용해 세션에 대해 이러한 매개 변수를 변경할 수 있습니다.
ACCOUNT계정 수준에서 설정할 수 있는 계정, 세션 및 오브젝트 매개 변수의 목록을 반환합니다. ACCOUNTADMIN 역할을 가진 사용자(예: 계정 관리자)는 ALTER ACCOUNT 를 통해 이러한 매개 변수를 변경할 수 있습니다. 자세한 내용은 매개 변수 관리 섹션을 참조하십시오.
USER [ name ]사용자가 로그인할 때마다 지정된 사용자(또는 현재 사용자)에 대해 설정된 세션 매개 변수 기본값의 목록을 반환합니다.
사용자를 지정하지 않으면 명령은 현재 사용자에 대한 결과를 반환합니다.
적절한 사용자 권한이 있는 관리자는 ALTER USER 를 사용해 사용자에 대한 세션 매개 변수 기본값을 변경할 수 있습니다.
개별 사용자는 ALTER USER 를 사용해 자신의 세션 매개 변수 기본값을 변경할 수도 있습니다.
WAREHOUSE | DATABASE | SCHEMA | TASK [ name ]현재/지정된 오브젝트에 대해 설정할 수 있는 오브젝트 매개 변수를 반환합니다. 적절한 권한이 있는 사용자는 해당 ALTER <오브젝트> 명령을 사용해 이러한 매개 변수를 변경할 수 있습니다.
TABLE name지정된 테이블에 대해 설정할 수 있는 오브젝트 매개 변수를 반환합니다. 적절한 권한이 있는 사용자는 ALTER TABLE 명령을 사용해 이러한 매개 변수를 변경할 수 있습니다.
기본값:
SESSION
사용법 노트¶
이 명령을 실행하기 위해 실행 중인 웨어하우스가 꼭 필요하지는 않습니다.
이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 RESULT_SCAN 함수를 사용하면 됩니다.
예¶
현재 세션에 대해 설정할 수 있는 모든 세션 매개 변수를 표시합니다.
SHOW PARAMETERS; +-------------------------------------+----------------------------------+----------------------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | key | value | default | level | description | |-------------------------------------+----------------------------------+----------------------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ABORT_DETACHED_QUERY | false | false | SESSION | If true, Snowflake will automatically abort queries when it detects that the client has disappeared. | | AUTOCOMMIT | true | true | SESSION | The autocommit property determines whether is statement should to be implicitly | | | | | | wrapped within a transaction or not. If autocommit is set to true, then a | | | | | | statement that requires a transaction is executed within a transaction | | | | | | implicitly. If autocommit is off then an explicit commit or rollback is required | | | | | | to close a transaction. The default autocommit value is true. | | AUTOCOMMIT_API_SUPPORTED | true | true | | Whether autocommit feature is enabled for this client. This parameter is for | | | | | | Snowflake use only. | | BINARY_INPUT_FORMAT | HEX | HEX | | input format for binary | | BINARY_OUTPUT_FORMAT | HEX | HEX | | display format for binary | | CLIENT_SESSION_KEEP_ALIVE | false | false | | If true, client session will not expire automatically | | DATE_INPUT_FORMAT | AUTO | AUTO | | input format for date | | DATE_OUTPUT_FORMAT | YYYY-MM-DD | YYYY-MM-DD | | display format for date | | ERROR_ON_NONDETERMINISTIC_MERGE | true | true | | raise an error when attempting to merge-update a row that joins many rows | | ERROR_ON_NONDETERMINISTIC_UPDATE | false | false | | raise an error when attempting to update a row that joins many rows | | LOCK_TIMEOUT | 43200 | 43200 | | Number of seconds to wait while trying to lock a resource, before timing out | | | | | | and aborting the statement. A value of 0 turns off lock waiting i.e. the | | | | | | statement must acquire the lock immediately or abort. If multiple resources | | | | | | need to be locked by the statement, the timeout applies separately to each | | | | | | lock attempt. | | QUERY_TAG | | | | String (up to 2000 characters) used to tag statements executed by the session | | QUOTED_IDENTIFIERS_IGNORE_CASE | false | false | | If true, the case of quoted identifiers is ignored | | ROWS_PER_RESULTSET | 0 | 0 | | maxium number of rows in a result set | | STATEMENT_QUEUED_TIMEOUT_IN_SECONDS | 0 | 0 | | Timeout in seconds for queued statements: statements will automatically be canceled if they are queued on a warehouse for longer than this amount of time; disabled if set to zero. | | STATEMENT_TIMEOUT_IN_SECONDS | 0 | 0 | | Timeout in seconds for statements: statements will automatically be canceled if they run for longer than this amount of time; disabled if set to zero. | | TIMESTAMP_DAY_IS_ALWAYS_24H | false | true | SYSTEM | If set, arithmetic on days always uses 24 hours per day, | | | | | | possibly not preserving the time (due to DST changes) | | TIMESTAMP_INPUT_FORMAT | AUTO | AUTO | | input format for timestamp | | TIMESTAMP_LTZ_OUTPUT_FORMAT | | | | Display format for TIMESTAMP_LTZ values. If empty, TIMESTAMP_OUTPUT_FORMAT is used. | | TIMESTAMP_NTZ_OUTPUT_FORMAT | YYYY-MM-DD HH24:MI:SS.FF3 | YYYY-MM-DD HH24:MI:SS.FF3 | SYSTEM | Display format for TIMESTAMP_NTZ values. If empty, TIMESTAMP_OUTPUT_FORMAT is used. | | TIMESTAMP_OUTPUT_FORMAT | YYYY-MM-DD HH24:MI:SS.FF3 TZHTZM | YYYY-MM-DD HH24:MI:SS.FF3 TZHTZM | SYSTEM | Default display format for all timestamp types. | | TIMESTAMP_TYPE_MAPPING | TIMESTAMP_NTZ | TIMESTAMP_NTZ | SYSTEM | If TIMESTAMP type is used, what specific TIMESTAMP* type it should map to: | | | | | | TIMESTAMP_LTZ (default), TIMESTAMP_NTZ or TIMESTAMP_TZ | | TIMESTAMP_TZ_OUTPUT_FORMAT | | | | Display format for TIMESTAMP_TZ values. If empty, TIMESTAMP_OUTPUT_FORMAT is used. | | TIMEZONE | America/Los_Angeles | America/Los_Angeles | | time zone | | TIME_INPUT_FORMAT | AUTO | AUTO | | input format for time | | TIME_OUTPUT_FORMAT | HH24:MI:SS | HH24:MI:SS | | display format for time | | TRANSACTION_ABORT_ON_ERROR | false | false | | If this parameter is true, and a statement issued within a non-autocommit | | | | | | transaction returns with an error, then the non-autocommit transaction is | | | | | | aborted. All statements issued inside that transaction will fail until an | | | | | | commit or rollback statement is executed to close that transaction. | | TRANSACTION_DEFAULT_ISOLATION_LEVEL | READ COMMITTED | READ COMMITTED | | The default isolation level when starting a starting a transaction, when no | | | | | | isolation level was specified | | TWO_DIGIT_CENTURY_START | 1970 | 1970 | | For 2-digit dates, defines a century-start year. | | | | | | For example, when set to 1980: | | | | | | - parsing a string '79' will produce 2079 | | | | | | - parsing a string '80' will produce 1980 | | UNSUPPORTED_DDL_ACTION | ignore | ignore | | The action to take upon encountering an unsupported ddl statement | | USE_CACHED_RESULT | true | true | | If enabled, query results can be reused between successive invocations of the same query as long as the original result has not expired | +-------------------------------------+----------------------------------+----------------------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+계정 또는 오브젝트 매개 변수는 세션 수준에서 설정할 수 없으므로 이 예의 출력은 이러한 매개 변수를 포함하지 않습니다.
계정 매개 변수뿐 아니라 계정 수준에서의 매개 변수 설정에 대한 자세한 내용은 매개 변수 관리 를 참조하십시오.
지정된 웨어하우스(testwh)에 대해 설정할 수 있는 모든 오브젝트 매개 변수를 표시합니다.
SHOW PARAMETERS IN WAREHOUSE testwh; +-------------------------------------+--------+---------+-------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | key | value | default | level | description | |-------------------------------------+--------+---------+-------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | MAX_CONCURRENCY_LEVEL | 8 | 8 | | Concurrency level for SQL statements (i.e. queries and DML) executed by a warehouse cluster (used to determine when statements are queued or additional clusters are started). Small SQL statements count as a fraction of 1. | | STATEMENT_QUEUED_TIMEOUT_IN_SECONDS | 0 | 0 | | Timeout in seconds for queued statements: statements will automatically be canceled if they are queued on a warehouse for longer than this amount of time; disabled if set to zero. | | STATEMENT_TIMEOUT_IN_SECONDS | 172800 | 172800 | | Timeout in seconds for statements: statements are automatically canceled if they run for longer; if set to zero, max value (604800) is enforced. | +-------------------------------------+--------+---------+-------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
현재 데이터베이스(testdb)에 대해 설정할 수 있는 모든 오브젝트 매개 변수를 표시합니다.
USE DATABASE testdb; SHOW PARAMETERS IN DATABASE; +-----------------------------+-------+---------+-------+------------------------------------------------------------------+ | key | value | default | level | description | |-----------------------------+-------+---------+-------+------------------------------------------------------------------| | DATA_RETENTION_TIME_IN_DAYS | 1 | 1 | | number of days to retain the old version of deleted/updated data | +-----------------------------+-------+---------+-------+------------------------------------------------------------------+