Kategorien:

DDL für Konten und Sitzungen

SHOW PARAMETERS

Listet alle einstellbaren Konten-, Sitzungs- und Objektparameter sowie die aktuellen Werte und die Standardwerte für jeden Parameter auf:

  • Kontoparameter können nur auf Kontoebene festgelegt werden.

  • Sitzungsparameter können auf Konto-, Benutzer- und Sitzungsebene festgelegt werden.

  • Objektparameter können auf Konto- und Objektebene festgelegt werden.

Wenn ein Parameter explizit festgelegt wurde, zeigt die Ausgabe dieses Befehls auch die Ebene an, auf der der Parameter festgelegt wurde.

Beschreibungen der verschiedenen Parametertypen sowie detaillierte Beschreibungen der einzelnen Parameter finden Sie unter Parameter.

Syntax

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

Parameter

LIKE 'Muster'

Filtert die Befehlsausgabe nach dem Objektnamen. Der Filter verwendet eine Mustererkennung ohne Berücksichtigung der Groß-/Kleinschreibung, aber mit Unterstützung von SQL-Platzhalterzeichen (% und _).

Die folgenden Muster geben zum Beispiel die gleichen Ergebnisse zurück:

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

Gibt den Umfang des Befehls an, der die zurückgegebenen Parameter bestimmt:

SESSION

Gibt alle Sitzungsparameter und ihre Einstellungen für die aktuelle Sitzung zurück. Ein Benutzer kann diese Parameter für seine Sitzung mit ALTER SESSION ändern.

ACCOUNT

Gibt eine Liste der Konto-, Sitzungs- und Objektparameter zurück, die auf Kontoebene festgelegt werden können. Ein Benutzer mit der Rolle ACCOUNTADMIN (z. B. Kontoadministrator) kann diese Parameter über ALTER ACCOUNT ändern. Weitere Informationen finden Sie unter Parameterverwaltung.

USER Name

Gibt eine Liste von Standardeinstellungen für die Sitzungsparameter zurück, die für den angegebenen Benutzer bei jeder Anmeldung des Benutzers festgelegt werden:

  • Ein Administrator mit den entsprechenden Benutzerberechtigungen kann die Standardeinstellungen für die Sitzungsparameter für einen Benutzer mithilfe von ALTER USER ändern.

  • Einzelne Benutzer können ihre Standardeinstellungen für die Sitzungsparameter auch mit ALTER USER ändern.

WAREHOUSE | DATABASE | SCHEMA | TASK [ Name ]

Gibt die Objektparameter zurück, die für das aktuelle/angegebene Objekt festgelegt werden können. Benutzer mit den entsprechenden Berechtigungen können diese Parameter mit dem entsprechenden Befehl ALTER <Objekt> ändern.

TABLE Name

Gibt die Objektparameter zurück, die für die angegebene Tabelle festgelegt werden können. Benutzer mit den entsprechenden Berechtigungen können diese Parameter mit dem Befehl ALTER TABLE ändern.

Standard: SESSION

Nutzungshinweise

  • Für die Ausführung des Befehl ist kein aktives Warehouse erforderlich.

  • Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt.

Beispiele

Zeigt alle Sitzungsparameter an, die für die aktuelle Sitzung festgelegt werden können:

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

Beachten Sie, dass die Ausgabe für dieses Beispiel keine Konto- oder Objektparameter enthält, da sie nicht auf Sitzungsebene festgelegt werden können.

Weitere Informationen zu Kontoparametern sowie zum Einstellen von Parametern auf Kontoebene finden Sie unter Parameterverwaltung.

Alle Objektparameter anzeigen, die für das angegebene Warehouse (testwh) festgelegt werden können:

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

Alle Objektparameter anzeigen, die für die aktuelle Datenbank (testdb) festgelegt werden können:

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