SHOW PARAMETERS

설정할 수 있는 모든 계정, 세션 및 오브젝트 매개 변수뿐 아니라, 각 매개 변수의 현재 값과 기본값도 나열합니다.

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

  • 세션 매개 변수는 계정, 사용자 및 세션 수준에서 설정할 수 있습니다.

  • 오브젝트 매개 변수는 계정 및 오브젝트 수준에서 설정할 수 있습니다.

매개 변수를 명시적으로 설정한 경우 이 명령의 출력에는 매개 변수를 설정한 수준도 표시됩니다.

다양한 매개 변수 유형에 대한 설명과 각 매개 변수에 대한 자세한 설명은 매개 변수 를 참조하십시오.

구문

SHOW PARAMETERS [ LIKE '<pattern>' ]
                [ { IN | FOR } { SESSION | ACCOUNT | USER [ <name> ] | { WAREHOUSE | DATABASE | SCHEMA | TASK } [ <name> ] | TABLE <table_name> } ]
Copy

매개 변수

LIKE 'pattern'

오브젝트 이름으로 명령 출력을 선택적으로 필터링합니다. 이 필터는 SQL 와일드카드 문자(%_) 지원과 함께 대/소문자를 구분하지 않는 패턴 일치를 사용합니다.

예를 들어, 다음 패턴은 같은 결과를 반환합니다.

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. 기본값: 값 없음(출력에 필터링이 적용되지 않음).

IN | FOR

IN ... 또는 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                                             |
+-------------------------------------+----------------------------------+----------------------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Copy

계정 또는 오브젝트 매개 변수는 세션 수준에서 설정할 수 없으므로 이 예의 출력은 이러한 매개 변수를 포함하지 않습니다.

계정 매개 변수뿐 아니라 계정 수준에서의 매개 변수 설정에 대한 자세한 내용은 매개 변수 관리 를 참조하십시오.

지정된 웨어하우스(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.                                                                              |
+-------------------------------------+--------+---------+-------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Copy

현재 데이터베이스(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 |
+-----------------------------+-------+---------+-------+------------------------------------------------------------------+
Copy