Catégories :

Compte et session DDL

SHOW PARAMETERS

Liste tous les paramètres de compte, de session et d’objet qui peuvent être définis, ainsi que les valeurs actuelles et par défaut de chaque paramètre :

  • Les paramètres de compte ne peuvent être définis qu’au niveau du compte.

  • Les paramètres de session peuvent être définis au niveau du compte, de l’utilisateur et de la session.

  • Les paramètres d’objet peuvent être définis au niveau du compte et de l’objet.

Si un paramètre a été explicitement défini, la sortie de cette commande indique également le niveau auquel le paramètre a été défini.

Pour obtenir la description des différents types de paramètres, ainsi que des descriptions détaillées de chaque paramètre, voir Paramètres.

Syntaxe

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

Paramètres

LIKE 'motif'

Filtre la sortie de commande par nom d’objet. Le filtre utilise une concordance de motif insensible à la casse avec prise en charge des caractères génériques SQL (% et _).

Par exemple, les motifs suivants donnent les mêmes résultats :

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

Spécifie la portée de la commande, qui détermine les paramètres qui sont retournés :

SESSION

Renvoie tous les paramètres de session et leurs réglages pour la session en cours. Un utilisateur peut modifier ces paramètres pour sa session en utilisant ALTER SESSION.

ACCOUNT

Renvoie une liste des paramètres de compte, de session et d’objet qui peuvent être définis au niveau du compte. Un utilisateur avec le rôle ACCOUNTADMIN (c’est-à-dire un administrateur de compte) peut modifier ces paramètres via ALTER ACCOUNT. Pour plus d’informations, voir Gestion des paramètres.

USER nom

Renvoie une liste des paramètres de session par défaut définis pour l’utilisateur spécifié chaque fois qu’il se connecte :

  • Un administrateur disposant des privilèges d’utilisateur appropriés peut modifier les paramètres de session par défaut d’un utilisateur à l’aide de la commande ALTER USER.

  • Les utilisateurs individuels peuvent également modifier leurs paramètres de session par défaut à l’aide de ALTER USER.

WAREHOUSE | DATABASE | SCHEMA | TASK [ nom ]

Renvoie les paramètres d’objet qui peuvent être définis pour l’objet actuel/spécifié. Les utilisateurs disposant des privilèges appropriés peuvent modifier ces paramètres à l’aide de la commande ALTER <objet> correspondante.

TABLE nom

Renvoie les paramètres de l’objet qui peuvent être définis pour la table spécifiée. Les utilisateurs disposant des privilèges appropriés peuvent modifier ces paramètres à l’aide de la commande ALTER TABLE.

Par défaut : SESSION

Notes sur l’utilisation

  • L’exécution de la commande ne nécessite pas l’exécution d’un entrepôt virtuel en cours d’exécution.

  • Pour post-traiter la sortie de cette commande, vous pouvez utiliser la fonction RESULT_SCAN, qui traite la sortie comme une table qui peut être interrogée.

Exemples

Afficher tous les paramètres de session qui peuvent être définis pour la session en cours :

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                                             |
+-------------------------------------+----------------------------------+----------------------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

Notez que la sortie de cet exemple n’inclut aucun des paramètres de compte ou d’objet car ils ne peuvent pas être définis au niveau de la session.

Pour plus d’informations sur les paramètres de compte, ainsi que sur le paramétrage au niveau du compte, voir Gestion des paramètres.

Afficher tous les paramètres d’objet qui peuvent être définis pour l’entrepôt virtuel spécifié (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).      |
| 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.                              |
+-------------------------------------+-------+---------+-------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

Afficher tous les paramètres d’objet qui peuvent être définis pour la base de données actuelle (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 |
+-----------------------------+-------+---------+-------+------------------------------------------------------------------+