Parameter¶
Snowflake bietet Parameter, mit denen Sie das Verhalten Ihres Kontos, einzelner Benutzersitzungen und Objekte steuern können. Alle Parameter verfügen über Standardwerte, die je nach Parametertyp (Konto, Sitzung oder Objekt) auf verschiedenen Ebenen festgelegt und anschließend überschrieben werden können.
Unter diesem Thema:
Parameterhierarchie und Typen¶
In diesem Abschnitt werden die verschiedenen Parametertypen (Konto, Sitzung und Objekt) und die Ebenen beschrieben, auf denen die einzelnen Typen festgelegt werden können.
Die folgende Abbildung veranschaulicht die hierarchische Beziehung zwischen den verschiedenen Parametertypen und wie einzelne Parameter auf jeder Ebene überschrieben werden können:
Kontoparameter¶
Kontoparameter können von Benutzern mit der entsprechenden Administratorrolle nur auf Kontoebene festgelegt werden. Kontoparameter werden mit dem Befehl ALTER ACCOUNT festgelegt.
Snowflake stellt die folgenden Kontoparameter bereit:
Parameter |
Anmerkungen |
---|---|
Wird verwendet, um das Verbindungscaching in browserbasiertem Single Sign-On (SSO) für von Snowflake bereitgestellte Clients zu aktivieren |
|
Wird zur Verschlüsselung von zum Laden oder Entladen von Daten im Stagingbereich bereitgestellten Dateien verwendet. Erfordert möglicherweise zusätzliche Installations- und Konfigurationsaktivitäten (Details siehe Beschreibung). |
|
Dient zur Angabe der Entscheidung eines Image-Repository, Tri-Secret Secure und Periodische Wiederverschlüsselung nicht zu verwenden. |
|
Erlaubt der Funktion SYSTEM$GET_PRIVATELINK_CONFIG, den Schlüssel |
|
Wird verwendet, um eine Ereignistabelle als aktive Ereignistabelle des Kontos festzulegen. |
|
Ermöglicht die Festlegung der minimalen Datenaufbewahrungsfrist für historische Daten von Time Travel-Operationen. |
|
Dies ist der einzige Kontoparameter, der entweder von Kontoadministratoren (d. h. Benutzern mit der Systemrolle ACCOUNTADMIN) oder Sicherheitsadministratoren (d. h. Benutzern mit der Systemrolle SECURITYADMIN) festgelegt werden kann. . Weitere Informationen finden Sie unter Objektparameter. |
|
Bemerkung
Kontoparameter werden in der Ausgabe von SHOW PARAMETERS standardmäßig nicht angezeigt. Weitere Informationen zum Anzeigen von Kontoparametern finden Sie unter Anzeigen von Parametern und deren Werten (unter diesem Thema).
Sitzungsparameter¶
Die meisten Parameter sind Sitzungsparameter, die auf folgenden Ebenen festgelegt werden können:
- Konto:
Kontoadministratoren können mit dem Befehl ALTER ACCOUNT Sitzungsparameter für das Konto festlegen. Die für das Konto festgelegten Werte werden standardmäßig für einzelne Benutzer und deren Sitzungen festgelegt.
- Benutzer:
Administratoren mit den entsprechenden Berechtigungen (typischerweise Rolle SECURITYADMIN) können den Befehl ALTER USER verwenden, um Sitzungsparameter für einzelne Benutzer zu überschreiben. Die für einen Benutzer festgelegten Werte werden standardmäßig für alle Sitzungen übernommen, die vom Benutzer gestartet werden. Darüber hinaus können Benutzer Standard-Sitzungsparameter mit ALTER USER für sich selbst überschreiben.
- Sitzung:
Benutzer können mit ALTER SESSION Sitzungsparameter innerhalb ihrer Sitzungen explizit festlegen.
Bemerkung
Standardmäßig werden nur Sitzungsparameter in der Ausgabe von SHOW PARAMETERS angezeigt. Weitere Informationen zum Anzeigen von Konto- und Objektparametern finden Sie unter Anzeigen von Parametern und deren Werten (unter diesem Thema).
Objektparameter¶
Objektparameter können auf folgenden Ebenen festgelegt werden:
- Konto:
Kontoadministratoren können mit dem Befehl ALTER ACCOUNT Objektparameter für das Konto festlegen. Die für das Konto festgelegten Werte werden standardmäßig für die im Konto erstellten Objekte verwendet.
- Objekt:
Benutzer mit den geeigneten Berechtigungen können die entsprechenden Befehle CREATE <Objekt> oder ALTER <Objekt> verwenden, um Objektparameter für ein einzelnes Objekt zu überschreiben.
Snowflake stellt die folgenden Objektparameter bereit:
Parameter |
Objekttyp |
Anmerkungen |
---|---|---|
Datenbank, Schema |
||
Datenbank, Schema, Tabelle |
||
Datenbank, Schema, Tabelle |
||
Replikationsgruppe, Failover-Gruppe |
Veraltet. Weitere Informationen dazu finden Sie unter ENABLE_ETL_REPLICATION. |
|
Benutzer |
Beeinflusst den Abfrageverlauf für Abfragen, die aufgrund von Syntax- oder Parsing-Fehlern fehlschlagen. |
|
Datenbank, Schema |
||
Datenbank, Schema, gespeicherte Prozedur, Funktion |
||
Warehouse |
||
Datenbank, Schema, Tabelle |
||
Schema, Pipe |
||
Benutzer |
||
Warehouse |
Auch ein Sitzungsparameter, d. h. er kann sowohl auf Objekt- als auch auf Sitzungsebene festgelegt werden. Informationen zur Vererbung und zum Überschreiben finden Sie in der Parameterbeschreibung. |
|
Warehouse |
Auch ein Sitzungsparameter, d. h. er kann sowohl auf Objekt- als auch auf Sitzungsebene festgelegt werden. Informationen zur Vererbung und zum Überschreiben finden Sie in der Parameterbeschreibung. |
|
Benutzer |
Dies ist der einzige Benutzerparameter, der entweder von Kontoadministratoren (d. h. Benutzern mit der Systemrolle ACCOUNTADMIN) oder Sicherheitsadministratoren (d. h. Benutzern mit der Systemrolle SECURITYADMIN) festgelegt werden kann. . Beachten Sie, dass die Netzwerkrichtlinie auf Benutzerebene Vorrang vor der Netzwerkrichtlinie auf Kontoebene hat, wenn dieser Parameter für das Konto und einen Benutzer desselben Kontos festgelegt ist. |
|
Datenbank, Schema, Aufgabe |
||
Datenbank, Schema, gespeicherte Prozedur, Funktion |
||
Datenbank, Schema, Aufgabe |
||
Datenbank, Schema, Aufgabe |
Bemerkung
Standardmäßig werden Objektparameter nicht in der Ausgabe von SHOW PARAMETERS angezeigt. Weitere Informationen zum Anzeigen von Objektparametern finden Sie unter Anzeigen von Parametern und deren Werten (unter diesem Thema).
Anzeigen von Parametern und deren Werten¶
Snowflake bietet den Befehl SHOW PARAMETERS, der eine Liste der Parameter zusammen mit den aktuellen Werten und den Standardwerten für jeden Parameter anzeigt. Der Befehl kann mit verschiedenen Optionen aufgerufen werden, um den angezeigten Parametertyp zu bestimmen.
Sitzungs- und Objektparameter anzeigen¶
Standardmäßig zeigt der Befehl nur Sitzungsparameter an:
SHOW PARAMETERS;
Um die Objektparameter für ein bestimmtes Objekt anzuzeigen, fügen Sie dem Objekttyp und dem Namen eine IN
-Klausel hinzu. Beispiel:
SHOW PARAMETERS IN DATABASE mydb; SHOW PARAMETERS IN WAREHOUSE mywh;
Anzeigen aller Parameter¶
Um alle -Parameter anzuzeigen, einschließlich Konto- und Objektparameter, fügen Sie eine IN ACCOUNT
-Klausel ein:
SHOW PARAMETERS IN ACCOUNT;
Einschränken der Liste der Parameter nach Namen¶
Der Befehl unterstützt auch die Verwendung einer LIKE
-Klausel, um die Liste der Parameter nach Namen einzuschränken. Beispiel:
So zeigen Sie die Sitzungsparameter an, deren Namen „time“ enthalten:
SHOW PARAMETERS LIKE '%time%';
So zeigen Sie die Sitzungsparameter an, deren Namen mit „time“ beginnen:
SHOW PARAMETERS LIKE 'time%' IN ACCOUNT;
Bemerkung
Die LIKE
-Klausel muss vor der IN-Klausel stehen.
ABORT_DETACHED_QUERY¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Beschreibung:
Gibt die Aktion an, die Snowflake für laufende Abfragen ausführt, wenn die Verbindung aufgrund einer abrupten Beendigung einer Sitzung (z. B. Netzwerkausfall, Browserbeendigung, Dienstunterbrechung) unterbrochen wird.
- Werte:
TRUE
: In Ausführung befindliche Abfragen werden 5 Minuten nach Verbindungsverlust abgebrochen.FALSE
: In Bearbeitung befindliche Abfragen werden abgeschlossen.- Standard:
FALSE
Bemerkung
Wenn der Benutzer die Verbindung explizit beendet, gilt Folgendes:
Alle synchron in Ausführung befindlichen Abfragen werden unabhängig vom Parameterwert sofort abgebrochen.
Wenn der Wert auf
FALSE
gesetzt ist, werden asynchrone Abfragen so lange ausgeführt, bis sie abgeschlossen sind oder bis sie abgebrochen werden oder bis das für den Parameter STATEMENT_TIMEOUT_IN_SECONDS angegebene Zeitlimit abgelaufen ist. Die Voreinstellung für den STATEMENT_TIMEOUT_IN_SECONDS-Parameter ist zwei Tage.
Die meisten Abfragen erfordern Computeressourcen zur Ausführung. Diese Ressourcen werden von virtuellen Warehouses bereitgestellt, die während des Betriebs Credits verbrauchen. Mit dem Wert
FALSE
können Warehouses nach Beendigung einer Sitzung weiterhin ausgeführt werden und Credits verbrauchen, um alle Abfragen abzuschließen, die sich bei Beenden der Sitzung noch in Ausführung befanden.
ALLOW_CLIENT_MFA_CACHING¶
- Typ:
Objekt – Kann nur für Konto eingestellt werden
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob ein MFA-Token im Keystore des clientseitigen Betriebssystems gespeichert werden kann, um für eine kontinuierliche, sichere Konnektivität zu sorgen, ohne dass Benutzer zu Beginn jedes Verbindungsversuchs zu Snowflake auf eine MFA-Eingabeaufforderung reagieren müssen. Einzelheiten und die Liste der unterstützten von Snowflake bereitgestellten Clients finden Sie unter Verwenden von MFA-Tokencaching zur Minimierung der Anzahl von Eingabeaufforderungen bei der Authentifizierung – Optional.
- Werte:
TRUE
: Speichert ein MFA-Token im Keystore des clientseitigen Betriebssystems, damit die Clientanwendung beim Herstellen einer neuen Verbindung das MFA-Token verwenden kann. Bei „true“ werden Benutzer nicht aufgefordert, auf zusätzliche MFA-Eingabeaufforderungen zu reagieren.FALSE
: Speichert kein MFA-Token. Benutzer müssen auf eine MFA-Eingabeaufforderung reagieren, wenn die Clientanwendung eine neue Verbindung mit Snowflake herstellt.- Standard:
FALSE
ALLOW_ID_TOKEN¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob ein Verbindungstoken im Keystore des clientseitigen Betriebssystems gespeichert werden kann, um eine kontinuierliche, sichere Konnektivität sicherzustellen, ohne dass Benutzer zu Beginn jedes Verbindungsversuchs zu Snowflake Anmeldeinformationen eingeben müssen. Einzelheiten und die Liste der unterstützten von Snowflake bereitgestellten Clients finden Sie unter Verwenden von Verbindungscaching zum Minimieren der Anzahl der Eingabeaufforderungen für die Authentifizierung – Optional.
- Werte:
TRUE
: Speichert ein Verbindungstoken im Keystore des clientseitigen Betriebssystems, damit die Clientanwendung browserbasiertes SSO ausführen kann, ohne Benutzer zur Authentifizierung aufzufordern, wenn eine neue Verbindung hergestellt wird.FALSE
: Speichert kein Verbindungstoken. Benutzer werden aufgefordert, sich zu authentifizieren, wenn die Clientanwendung eine neue Verbindung mit Snowflake herstellt. SSO für Verbindung zu Snowflake ist weiterhin möglich, wenn dieser Parameter auf „false“ gesetzt ist.- Standard:
FALSE
AUTOCOMMIT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob Autocommit für die Sitzung aktiviert ist. Autocommit bestimmt, ob eine DML-Anweisung automatisch committet wird, wenn die Anweisung ohne aktive Transaktion ausgeführt wird, nachdem die Anweisung erfolgreich abgeschlossen wurde. Weitere Informationen dazu finden Sie unter Transaktionen.
- Werte:
TRUE
: Autocommit ist aktiviert.FALSE
: Autocommit ist deaktiviert, d. h. DML-Anweisungen müssen explizit committet oder rückgängig gemacht werden.- Standard:
TRUE
AUTOCOMMIT_API_SUPPORTED (schreibgeschützt)¶
- Typ:
N/A
- Datentyp:
Boolesch
- Beschreibung:
Nur für den internen Gebrauch von Snowflake. Schreibgeschützter Parameter, der angibt, ob die API-Unterstützung für Autocommit für Ihr Konto aktiviert ist. Wenn der Wert
TRUE
ist, können Sie Autocommit über APIs für die folgenden Treiber/Konnektoren aktivieren oder deaktivieren:
BINARY_INPUT_FORMAT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (Konstante)
- Beschreibung:
Das Format der VARCHAR-Werte, die als Eingabewerte an VARCHAR-BINARY-Konvertierungsfunktionen übergeben werden. Weitere Informationen dazu finden Sie unter Binary Input and Output.
- Werte:
HEX
,BASE64
oderUTF8
/UTF-8
- Standard:
HEX
BINARY_OUTPUT_FORMAT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (Konstante)
- Beschreibung:
Das Format für VARCHAR-Werte, die von BINARY-VARCHAR-Konvertierungsfunktionen zurückgegeben werden. Weitere Informationen dazu finden Sie unter Binary Input and Output.
- Werte:
HEX
oderBASE64
- Standard:
HEX
CATALOG¶
- Typ:
Objekt (für Datenbanken und Schemas) – Kann festgelegt werden für Konto » Datenbank » Schema
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt eine Standard-Katalogintegration für Iceberg-Tabellen an. Weitere Informationen dazu finden Sie in der Dokumentation zu Iceberg-Tabellen.
- Werte:
Jeder gültige Bezeichner der Katalogintegration.
- Standard:
Keine
CLIENT_ENABLE_LOG_INFO_STATEMENT_PARAMETERS¶
- Typ:
Sitzung – Kann nur für Sitzung festgelegt werden
- Datentyp:
Boolesch
- Clients:
JDBC
- Beschreibung:
Ermöglicht Benutzern das Protokollieren der an PreparedStatements gebundenen Datenwerte.
Um die Werte anzuzeigen, müssen Sie nicht nur diesen Parameter auf Sitzungsebene auf
TRUE
setzen, sondern auch den Verbindungsparameter mit dem NamenTRACING
aufINFO
oderALL
.Setzen Sie
TRACING
aufALL
, um alle Debugging-Informationen und alle Bindungsinformationen anzuzeigen.Setzen Sie
TRACING
aufINFO
, um die Bindungsparameterwerte und wenige andere Debugging-Informationen anzuzeigen.
Vorsicht
Wenn Sie vertrauliche Informationen, wie z. B. medizinische Diagnosen oder Kennwörter, eingeben, werden diese Informationen protokolliert. Snowflake empfiehlt, sicherzustellen, dass die Protokolldatei sicher ist, oder nur Testdaten zu verwenden, wenn Sie diesen Parameter auf
TRUE
setzen.- Werte:
TRUE
oderFALSE
.- Standard:
FALSE
CLIENT_ENCRYPTION_KEY_SIZE¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Ganzzahl (Integer)
- Clients:
Beliebig
- Beschreibung:
Gibt bei Verwendung des Verschlüsselungstyps
SNOWFLAKE_FULL
die AES-Verschlüsselungsschlüsselgröße in Bit an, die von Snowflake verwendet wird, um Dateien zu verschlüsseln/entschlüsseln, die in internen Stagingbereichen (zum Laden/Entladen von Daten) gespeichert sind.- Werte:
128
oder256
- Standard:
128
Bemerkung
Dieser Parameter wird nicht zum Verschlüsseln/Entschlüsseln von Dateien verwendet, die in externen Stagingbereichen (d. h. S3-Bucket oder Azure-Container) gespeichert sind. Die Verschlüsselung/Entschlüsselung dieser Dateien erfolgt mithilfe eines externen Verschlüsselungsschlüssels, der explizit im COPY-Befehl oder in dem im Befehl angegebenen externen Stagingbereich angegeben ist.
Wenn Sie den JDBC-Treiber verwenden und diesen Parameter auf 256 setzen (für eine starke Verschlüsselung), müssen auf jedem Clientcomputer, von dem Daten geladen/entladen werden, zusätzliche JCE-Richtliniendateien installiert werden. Weitere Informationen zum Installieren der erforderlichen Dateien finden Sie unter Java-Anforderungen an den JDBC-Treiber.
Wenn Sie den Python-Konnektor (oder SnowSQL) verwenden und diesen Parameter auf 256 setzen (für starke Verschlüsselung), sind keine zusätzlichen Installations- oder Konfigurationsaufgaben erforderlich.
CLIENT_MEMORY_LIMIT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Ganzzahl (Integer)
- Clients:
JDBC, ODBC
- Beschreibung:
Parameter, der die maximale Speichermenge (in MB) angibt, die der JDBC- oder ODBC-Treiber für Resultsets von Abfragen verwenden darf.
JDBC-Treiber:
Um die JVM-Speicherverwaltung zu vereinfachen, legt der Parameter ein maximales globales Speichernutzungslimit für alle Abfragen fest.
CLIENT_RESULT_CHUNK_SIZE gibt die maximale Größe (in MB) jedes Sets (oder Blocks) der herunterzuladenden Abfrageergebnisse an. Der Treiber benötigt möglicherweise zusätzlichen Speicher, um einen Block zu verarbeiten. Wenn dies der Fall ist, wird die Speichernutzung zur Laufzeit so angepasst, dass mindestens ein Thread bzw. eine Abfrage verarbeitet wird. Vergewissern Sie sich, dass CLIENT_MEMORY_LIMIT deutlich höher als CLIENT_RESULT_CHUNK_SIZE eingestellt ist, um sicherzustellen, dass ausreichend Speicher verfügbar ist.
ODBC-Treiber:
Dieser Parameter wird ab Version 2.22.0 unterstützt.
CLIENT_RESULT_CHUNK_SIZE
wird nicht unterstützt.
Bemerkung
Der Treiber versucht, den Parameterwert einzuhalten, begrenzt jedoch die Nutzung auf 80 % des Arbeitsspeichers Ihres Systems.
Das in diesem Parameter festgelegte Speichernutzungslimit gilt nicht für andere JDBC- oder ODBC-Treiberoperationen (z. B. Herstellen einer Verbindung mit der Datenbank, Vorbereiten einer Abfrage oder PUT- und GET-Anweisungen).
- Werte:
Jede gültige Anzahl von Megabytes.
- Standard:
1536
(effektiv 1,5 GB)Die meisten Benutzer sollten diesen Parameter nicht einstellen müssen. Wenn dieser Parameter nicht vom Benutzer festgelegt wird, beginnt der Treiber mit der oben angegebenen Standardeinstellung.
Darüber hinaus verwaltet der JDBC-Treiber aktiv seinen Arbeitsspeicher, um zu vermeiden, dass der gesamte verfügbare Speicher belegt wird.
CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX¶
- Typ:
Sitzung – Kann festgelegt werden für Benutzer » Sitzung
- Datentyp:
Boolesch
- Clients:
JDBC, ODBC
- Beschreibung:
Für bestimmte ODBC-Funktionen und JDBC-Methoden kann mit diesem Parameter der Standardsuchbereich aller Datenbanken/Schemas auf die aktuelle Datenbank bzw. das aktuelle Schema geändert werden. Bei einer eingegrenzten Suche werden normalerweise weniger Zeilen zurückgegeben und die Suche wird schneller ausgeführt.
Beispielsweise akzeptiert die JDBC-Methode
getTables()
einen Datenbanknamen und einen Schemanamen als Argumente und gibt die Namen der Tabellen in der Datenbank und im Schema zurück. Wenn die Datenbank- und Schemaargumentenull
sind, durchsucht die Methode standardmäßig alle Datenbanken und alle Schemas im Konto. Wenn Sie CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX aufTRUE
setzen, wird die Suche auf die aktuelle Datenbank und das aktuelle Schema eingegrenzt, die im Verbindungskontext angegeben sind.Wenn Sie diesen Parameter auf
TRUE
setzen, wird im Wesentlichen die folgende Rangfolge für Datenbank und Schema erstellt:Werte, die als Argumente an die Funktionen/Methoden übergeben wurden.
Im Verbindungskontext angegebene Werte (falls vorhanden).
Standard (alle Datenbanken und alle Schemas).
Weitere Details dazu finden Sie weiter unten.
Dieser Parameter gilt für Folgendes:
JDBC-Treibermethoden (für Klasse
DatabaseMetaData
):getColumns
getCrossReference
getExportedKeys
getForeignKeys
getFunctions
getImportedKeys
getPrimaryKeys
getSchemas
getTables
ODBC-Treiberfunktionen:
SQLTables
SQLColumns
SQLPrimaryKeys
SQLForeignKeys
SQLGetFunctions
SQLProcedures
- Werte:
TRUE
: Wenn die Datenbank- und Schemaargumentenull
sind, ruft der Treiber Metadaten nur für die Datenbank und das Schema ab, die im Verbindungskontext angegeben sind.Die Interaktion wird in der folgenden Tabelle ausführlicher beschrieben.
FALSE
: Wenn die Datenbank- und Schemaargumentenull
sind, ruft der Treiber Metadaten für alle Datenbanken und Schemas im Konto ab.- Standard:
FALSE
- Zusätzliche Anmerkungen:
Der Verbindungskontext bezieht sich auf die aktuelle Datenbank und das aktuelle Schema der Sitzung, die mit einer der folgenden Optionen festgelegt werden kann:
Geben Sie den Standard-Namespace für den Benutzer an, der eine Verbindung zu Snowflake herstellt (und die Sitzung initiiert). Dies kann für den Benutzer über den Befehl CREATE USER oder ALTER USER festgelegt werden, muss aber vor dem Verbinden eingestellt werden.
Geben Sie die Datenbank und das Schema an, wenn Sie über den Treiber eine Verbindung zu Snowflake herstellen.
Führen Sie innerhalb der Sitzung einen USE DATABASE- oder USE SCHEMA-Befehl aus.
Wenn bei der Angabe von Datenbank oder Schema nicht nur eine dieser Optionen verwendet wurde, gilt die zuletzt verwendete Option.
Wenn CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX auf
TRUE
gesetzt ist:Datenbankargument
Schemaargument
Verwendete Datenbank
Verwendetes Schema
Ungleich NULL
Ungleich NULL
Argument
Argument
Ungleich NULL
NULL
Argument
Alle Schemas
NULL
Ungleich NULL
Verbindungssyntax
Argument
NULL
NULL
Verbindungssyntax
Sitzungskontext
Bemerkung
Für den JDBC-Treiber gilt dieses Verhalten für Version 3.6.27 (und höher). Für den ODBC-Treiber gilt dieses Verhalten für Version 2.12.96 (und höher).
Wenn Sie nur die Verbindungskontextdatenbank durchsuchen möchten, aber alle Schemas in dieser Datenbank, dann finden Sie weitere Informationen unter CLIENT_METADATA_USE_SESSION_DATABASE.
CLIENT_METADATA_USE_SESSION_DATABASE¶
- Typ:
Sitzung – Kann für Sitzung festgelegt werden
- Datentyp:
Boolesch
- Clients:
JDBC
- Beschreibung:
Dieser Parameter gilt nur für die von CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX betroffenen Methoden.
Dieser Parameter gilt nur, wenn beide der folgenden Bedingungen erfüllt sind:
CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX ist auf
FALSE
oder nicht gesetzt.Weder Datenbank noch Schema werden an die entsprechende ODBC-Funktion oder JDBC-Methode übergeben.
Für bestimmte ODBC-Funktionen und JDBC-Methoden kann dieser Parameter den Standardsuchbereich aller Datenbanken der aktuellen Datenbank ändern. Bei einer eingegrenzten Suche werden normalerweise weniger Zeilen zurückgegeben und die Suche wird schneller ausgeführt.
Weitere Details dazu finden Sie weiter unten.
- Werte:
TRUE
:Der Treiber durchsucht alle Schemas in der Datenbank des Verbindungskontexts. (Weitere Informationen zum Verbindungskontext finden Sie in der Dokumentation zu CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX.)
FALSE
:Der Treiber durchsucht alle Schemas in allen Datenbanken.
- Standard:
FALSE
- Zusätzliche Anmerkungen:
Wenn die Datenbank null
und das Schema null
und CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX FALSE ist:
CLIENT_METADATA_USE_SESSION_DATABASE
Verhalten
FALSE
Es werden alle Schemas in allen Datenbanken durchsucht.
TRUE
Es werden alle Schemas der aktuellen Datenbank durchsucht.
CLIENT_PREFETCH_THREADS¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Ganzzahl (Integer)
- Clients:
JDBC, ODBC, Python, .NET
- Beschreibung:
Parameter, der die Anzahl der Threads angibt, die vom Client vorab zum Abrufen großer Resultsets verwendet werden. Der Treiber versucht, den Parameterwert einzuhalten, definiert jedoch Mindest- und Höchstwerte (abhängig von den Ressourcen Ihres Systems), um die Leistung zu verbessern.
- Werte:
1
bis10
- Standard:
4
Die meisten Benutzer sollten diesen Parameter nicht einstellen müssen. Wenn dieser Parameter nicht vom Benutzer festgelegt wird, beginnt der Treiber mit der oben angegebenen Standardeinstellung, verwaltet jedoch aktiv die Thread-Anzahl konservativ, um zu vermeiden, dass der gesamte verfügbare Speicher belegt wird.
CLIENT_RESULT_CHUNK_SIZE¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Ganzzahl (Integer)
- Clients:
JDBC, SQL API
- Beschreibung:
Parameter, der die maximale Größe jedes Sets (oder Blocks) der herunterzuladenden Abfrageergebnisse (in MB) angibt. Der JDBC-Treiber lädt Abfrageergebnisse in Blöcken herunter.
Siehe auch CLIENT_MEMORY_LIMIT.
- Werte:
48
bis160
- Standard:
160
Die meisten Benutzer sollten diesen Parameter nicht einstellen müssen. Wenn dieser Parameter nicht vom Benutzer festgelegt wird, beginnt der Treiber mit der oben angegebenen Standardeinstellung, verwaltet seinen Speicher jedoch aktiv und konservativ, um zu vermeiden, dass der gesamte verfügbare Speicher belegt wird.
CLIENT_RESULT_COLUMN_CASE_INSENSITIVE¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Clients:
JDBC
- Beschreibung:
Parameter, der angibt, ob bei
ResultSet.get*
-Methoden in JDBC bei einem Vergleich der Spaltennamen die Groß-/Kleinschreibung berücksichtigt werden soll.- Werte:
TRUE
: Vergleicht Spaltennamen ohne Berücksichtigung der Groß-/Kleinschreibung.FALSE
: Vergleicht Spaltennamen unter Berücksichtigung der Groß-/Kleinschreibung.- Standard:
FALSE
CLIENT_SESSION_KEEP_ALIVE¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Clients:
JDBC, ODBC, Python, Node.js
- Beschreibung:
Parameter, der angibt, ob sich ein Benutzer nach einem Zeitraum der Inaktivität in einer Sitzung erneut anmelden muss.
- Werte:
TRUE
: Snowflake hält die Sitzung unbegrenzt aktiv, solange die Verbindung aktiv ist, auch wenn der Benutzer inaktiv ist.FALSE
: Nach vier Stunden Inaktivität muss sich der Benutzer erneut anmelden.- Standard:
FALSE
Bemerkung
Derzeit ist der Parameter nur bei der Initiierung der Sitzung wirksam. Sie können den Parameterwert innerhalb der Sitzungsebene ändern, indem Sie den Befehl ALTER SESSION ausführen. Dies hat jedoch keinen Einfluss auf die Funktion zur Aufrechterhaltung der Sitzung, wie z. B. die Verlängerung der Sitzung. Informationen zum Festlegen des Parameters auf Sitzungsebene finden Sie in der jeweiligen Clientdokumentation:
CLIENT_SESSION_KEEP_ALIVE_HEARTBEAT_FREQUENCY¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Ganzzahl (Integer)
- Clients:
SnowSQL, JDBC, Python, Node.js
- Beschreibung:
Anzahl der Sekunden zwischen den Versuchen des Clients, das Token für die Sitzung zu aktualisieren.
- Werte:
900
bis3600
- Standard:
3600
CLIENT_TIMESTAMP_TYPE_MAPPING¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (Konstante)
- Clients:
Beliebig
- Beschreibung:
Gibt die Variation TIMESTAMP_* an, die beim Binden von Zeitstempelvariablen für JDBC- oder ODBC-Anwendungen verwendet werden soll, welche zum Laden von Daten die Bind-API verwenden.
- Werte:
TIMESTAMP_LTZ
oderTIMESTAMP_NTZ
- Standard:
TIMESTAMP_LTZ
DATA_RETENTION_TIME_IN_DAYS¶
- Typ:
Objekt (für Datenbanken, Schemas und Tabellen) – Kann festgelegt werden für Konto » Datenbank » Schema » Tabelle
- Datentyp:
Ganzzahl (Integer)
- Beschreibung:
Anzahl der Tage, für die Snowflake historische Daten zu einem Objekt zur Durchführung von Time Travel-Aktionen (SELECT, CLONE, UNDROP) speichert. Der Wert
0
deaktiviert Time Travel für die angegebene Datenbank, das angegebene Schema oder die angegebene Tabelle. Weitere Informationen dazu finden Sie unter Verstehen und Verwenden von Time Travel.- Werte:
0
oder1
(für Standard Edition)0
bis90
(für Enterprise Edition oder höher)- Standard:
1
DATE_INPUT_FORMAT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt das Eingabeformat für den Datentyp DATE an. Weitere Informationen dazu finden Sie unter Eingabe- und Ausgabeformate für Datum und Uhrzeit.
- Werte:
Jedes gültige, unterstützte Datumsformat oder
AUTO
(
AUTO
gibt an, dass Snowflake versucht, das Format der im System gespeicherten Daten während der Sitzung automatisch zu ermitteln.)- Standard:
AUTO
DATE_OUTPUT_FORMAT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt das Anzeigeformat für den Datentyp DATE an. Weitere Informationen dazu finden Sie unter Eingabe- und Ausgabeformate für Datum und Uhrzeit.
- Werte:
Jedes gültige, unterstützte Datumsformat
- Standard:
YYYY-MM-DD
DEFAULT_DDL_COLLATION¶
- Typ:
Objekt (für Datenbanken, Schemas und Tabellen) – Kann festgelegt werden für Konto » Datenbank » Schema » Tabelle
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Legt die Standardsortierung für die folgenden DDL-Operationen fest:
ALTER TABLE … ADD COLUMN
Wenn Sie diesen Parameter festlegen, wird für alle nachfolgend erstellten Spalten in den betroffenen Objekten (Tabelle, Schema, Datenbank oder Konto) die angegebene Sortierung als Standardsortierung festgelegt, sofern die Sortierung für die Spalte nicht ausdrücklich in DDL angegeben ist.
Wenn beispielsweise
DEFAULT_DDL_COLLATION = 'en-ci'
ist, sind die folgenden beiden Anweisungen äquivalent:create table test(c1 integer, c2 string, c3 string collate 'en-cs'); create table test(c1 integer, c2 string collate 'en-ci', c3 string collate 'en-cs');
- Werte:
Jede gültige, unterstützte Sortierungsspezifikation.
- Standard:
Leere Zeichenfolge
Bemerkung
Verwenden Sie die folgenden Befehle, um die Standardsortierung für das Konto festzulegen:
Die Standardsortierung für Tabellenspalten kann während der Erstellung oder zu einem späteren Zeitpunkt auf Tabellen-, Schema- oder Datenbankebene festgelegt werden:
CREATE TABLE oder ALTER TABLE
ENABLE_ETL_REPLICATION¶
ENABLE_IDENTIFIER_FIRST_LOGIN¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Boolesch
- Beschreibung:
Bestimmt den Anmeldeablauf für Benutzer. Wenn diese Option aktiviert ist, fordert Snowflake die Benutzer zur Eingabe ihres Benutzernamens oder ihrer E-Mail-Adresse auf, bevor die Authentifizierungsmethoden angezeigt werden. Weitere Details dazu finden Sie unter ID-First-Anmeldung.
- Werte:
TRUE
: Snowflake verwendet für die Authentifizierung der Benutzer einen ID-First-Anmeldeablauf.FALSE
: Snowflake zeigt alle möglichen Anmeldeoptionen an, auch wenn diese Optionen nicht für einen bestimmten Benutzer zutreffen.- Standard:
FALSE
ENABLE_INTERNAL_STAGES_PRIVATELINK¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob die Funktion SYSTEM$GET_PRIVATELINK_CONFIG den Schlüssel
private-internal-stages
im Abfrageergebnis zurückgibt. Der entsprechende Wert im Abfrageergebnis wird verwendet, wenn die private Konnektivität zu internen Stagingbereichen konfiguriert wird.- Werte:
TRUE
: Gibt den Schlüsselprivate-internal-stages
und den Wert im Abfrageergebnis zurück.FALSE
: Gibt den Schlüsselprivate-internal-stages
und den Wert im Abfrageergebnis nicht zurück.- Standard:
FALSE
ENABLE_TRI_SECRET_AND_REKEY_OPT_OUT_FOR_IMAGE_REPOSITORY¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Boolesch
- Beschreibung:
Gibt die Wahl für das Image-Repository an, sich gegen Tri-Secret Secure und Periodische Wiederverschlüsselung zu entscheiden.
- Werte:
TRUE
: Entscheidet sich für Tri-Secret Secure und periodische Wiederverschlüsselung (Periodic Rekeying) für das Image-Repository.FALSE
: Verhindert das Erstellen eines Image-Repository für Tri-Secret Secure-Konten und Konten mit periodischer Wiederverschlüsselung (Periodic Rekeying). Gleichermaßen ist das Aktivieren von Tri-Secret Secure und periodischer Wiederverschlüsselung (Periodic Rekeying) für Konten, bei denen das Image-Repository aktiviert ist, nicht zugelassen.- Standard:
FALSE
ENABLE_UNHANDLED_EXCEPTIONS_REPORTING¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob Snowflake in einer Ereignistabelle Protokollmeldungen oder Ablaufverfolgungsereignisse für unbehandelte Ausnahmen mit Prozedur- oder UDF-Handler-Code erfassen darf. Weitere Informationen dazu finden Sie unter Erfassen von Meldungen aus unbehandelten Ausnahmen.
- Werte:
TRUE
: Daten zu unbehandelten Ausnahmen werden als Protokoll- oder Ablaufverfolgungsdaten erfasst, wenn Protokollierung und Ablaufverfolgung aktiviert sind.FALSE
: Daten zu nicht behandelte Ausnahmen werden nicht erfasst.- Standard:
TRUE
ENABLE_UNLOAD_PHYSICAL_TYPE_OPTIMIZATION¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob das Schema für entladene Parquet-Dateien basierend auf den Datentypen der logischen Spalte (d. h. den Typen in der SQL-Entladeabfrage oder der Quelltabelle) oder den entladenen Spaltenwerten (d. h. die kleinsten Datentypen und Genauigkeiten, die die Werte in den Ausgabespalten der SQL-Entladeanweisung oder der Quelltabelle unterstützen) festgelegt werden soll.
- Werte:
TRUE
: Das Schema für entladene Parquet-Datendateien wird durch die Spaltenwerte in der SQL-Entladeabfrage oder der Quelltabelle bestimmt. Snowflake optimiert Tabellenspalten, indem die kleinste Genauigkeit festgelegt wird, die alle Werte akzeptiert. Der Entlader folgt diesem Muster, wenn Werte in Parquet-Dateien geschrieben werden. Der Datentyp und die Genauigkeit einer Ausgabespalte werden auf den kleinsten Datentyp und die kleinste Genauigkeit festgelegt, die ihre Werte in der unload-SQL-Anweisung oder in der Quelltabelle unterstützen. Akzeptieren Sie diese Einstellung, um die Leistung zu verbessern und kleinere Datendateien zu erhalten.FALSE
: Das Schema wird durch die Datentypen der logischen Spalten bestimmt. Legen Sie diesen Wert für ein konsistentes Ausgabedateischema fest.- Standard:
TRUE
ENABLE_UNREDACTED_QUERY_SYNTAX_ERROR¶
- Typ:
Benutzer – Kann für Konto » Benutzer festgelegt werden
- Datentyp:
Boolesch
- Beschreibung:
Steuert, ob bei Fehlschlagen einer SQL-Abfrage aufgrund eines Syntax- oder Parsing-Fehlers Abfragetext ausgeblendet wird. Bei
FALSE
wird der Inhalt einer fehlgeschlagenen Abfrage in den Ansichten, Seiten und Funktionen, die einen Abfrageverlauf bereitstellen, ausgeblendet.Nur Benutzer mit einer Rolle, der die Berechtigung AUDIT erteilt wurde oder die diese Berechtigung geerbt hat, können den Parameter ENABLE_UNREDACTED_QUERY_SYNTAX_ERROR festlegen.
Wenn Sie den Befehl ALTER USER verwenden, um den Parameter für einen bestimmten Benutzer auf
TRUE
zu setzen, ändern Sie den Benutzer, der den Abfragetext sehen soll, und nicht den Benutzer, der die Abfrage ausgeführt hat (falls es sich um verschiedene Benutzer handelt).- Werte:
TRUE
: Deaktiviert das Ausblenden von Abfragetext bei Abfragen, die aufgrund eines Syntax- oder Parsing-Fehlers fehlschlagen.FALSE
: Blendet bei Fehlschlagen einer Abfrage aufgrund eines Syntax- oder Parsing-Fehlers den Abfragetext in Ansichten, Seiten und Funktionen aus, die einen Abfrageverlauf bereitstellen.- Standard:
FALSE
ENFORCE_NETWORK_RULES_FOR_INTERNAL_STAGES¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob eine Netzwerkrichtlinie, die Netzwerkregeln verwendet, den Zugriff auf interne AWS-Stagingbereiche einschränken kann.
Dieser Parameter hat keine Auswirkungen auf Netzwerkrichtlinien, die keine Netzwerkregeln verwenden.
Dieser Parameter auf Kontoebene betrifft sowohl Netzwerkrichtlinien auf Konto- als auch auf Benutzerebene.
Einzelheiten zur Verwendung von Netzwerkrichtlinien und -regeln zur Beschränkung des Zugriffs auf interne AWS-Stagingbereich, einschließlich der Verwendung dieses Parameters, finden Sie unter Schutz der internen Stagingbereiche auf AWS.
- Werte:
TRUE
: Erlaubt Netzwerkrichtlinien, die Zugriff auf interne AWS-Stagingbereiche durch Netzwerkregeln beschränken. Die Netzwerkregel muss auch den entsprechendenMODE
undTYPE
verwenden, um Zugriff auf interne Stagingbereiche zu beschränken.FALSE
: Netzwerkrichtlinien beschränken niemals den Zugriff auf interne Stagingbereiche.- Standard:
FALSE
ERROR_ON_NONDETERMINISTIC_MERGE¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob ein Fehler zurückgegeben werden soll, wenn der Befehl MERGE zum Aktualisieren oder Löschen einer Zielzeile verwendet wird, die mehrere Quellzeilen verknüpft, und das System nicht ermitteln kann, welche Aktion in der Zielzeile ausgeführt werden soll.
- Werte:
TRUE
: Es wird ein Fehler zurückgegeben, der Werte aus einer der Zielzeilen enthält, die den Fehler verursacht haben.FALSE
: Es wurde kein Fehler zurückgegeben, und die Zusammenführung wurde erfolgreich abgeschlossen. Die Ergebnisse der Zusammenführung sind jedoch nicht deterministisch.- Standard:
TRUE
ERROR_ON_NONDETERMINISTIC_UPDATE¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob ein Fehler zurückgegeben werden soll, wenn der Befehl UPDATE zum Aktualisieren einer Zielzeile verwendet wird, die mehrere Quellzeilen verknüpft, und das System nicht bestimmen kann, welche Aktion in der Zielzeile ausgeführt werden soll.
- Werte:
TRUE
: Es wird ein Fehler zurückgegeben, der Werte aus einer der Zielzeilen enthält, die den Fehler verursacht haben.FALSE
: Es wurde kein Fehler zurückgegeben, und die Aktualisierung wurde abgeschlossen. Die Ergebnisse der Aktualisierung sind jedoch nicht deterministisch.- Standard:
FALSE
EVENT_TABLE¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt den Namen der Ereignistabelle für das Protokollieren von Meldungen aus gespeicherten Prozeduren und UDFs in diesem Konto an.
- Werte:
Jede vorhandene Ereignistabelle, die durch Ausführen des Befehls CREATE EVENT TABLE erstellt wurde.
- Standard:
Keine
EXTERNAL_OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Boolesch
- Beschreibung:
Bestimmt, ob die Rollen ACCOUNTADMIN, ORGADMIN und SECURITYADMIN als Primärrolle verwendet werden können, wenn eine Snowflake-Sitzung auf Basis des Zugriffstokens vom External OAuth-Autorisierungsserver erstellt wird.
- Werte:
TRUE
: Fügt die Rollen ACCOUNTADMIN, ORGADMIN und SECURITYADMIN der EigenschaftEXTERNAL_OAUTH_BLOCKED_ROLES_LIST
der External OAuth-Sicherheitsintegration hinzu, was bedeutet, dass diese Rollen beim Erstellen einer Snowflake-Sitzung mit External OAuth-Authentifizierung nicht als Primärrolle verwendet werden können.FALSE
: Entfernt ACCOUNTADMIN, ORGADMIN und SECURITYADMIN aus der Liste der gesperrten Rollen, die durch die EigenschaftEXTERNAL_OAUTH_BLOCKED_ROLES_LIST
der External OAuth-Sicherheitsintegration definiert sind.- Standard:
TRUE
EXTERNAL_VOLUME¶
- Typ:
Objekt (für Datenbanken und Schemas) – Kann festgelegt werden für Konto » Datenbank » Schema
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt ein externes Volume an, das standardmäßig für Iceberg-Tabellen verwendet wird. Weitere Informationen dazu finden Sie in der Dokumentation zu Iceberg-Tabellen.
- Werte:
Jeder gültige Bezeichner eines externen Volumes.
- Standard:
Keine
GEOGRAPHY_OUTPUT_FORMAT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (Konstante)
- Beschreibung:
Anzeigeformat für GEOGRAPHY-Werte.
Für EWKT und EWKB ist die SRID in der Ausgabe immer „4326“. Siehe Hinweis zur Verwendung von EWKT und EWKB.
- Werte:
GeoJSON
,WKT
,WKB
,EWKT
oderEWKB
- Standard:
GeoJSON
GEOMETRY_OUTPUT_FORMAT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (Konstante)
- Beschreibung:
Anzeigeformat für GEOMETRY-Werte.
- Werte:
GeoJSON
,WKT
,WKB
,EWKT
oderEWKB
- Standard:
GeoJSON
INITIAL_REPLICATION_SIZE_LIMIT_IN_TB¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Zahl.
- Beschreibung:
Legt die maximale, geschätzte Größenbeschränkung fest, die bei der erstmaligen Replikation einer Primärdatenbank in eine Sekundärdatenbank (in TB) angewendet wird. Setzen Sie diesen Parameter für jedes Konto, das eine sekundäre Datenbank speichert. Durch diese Größenbeschränkung wird verhindert, dass Konten versehentlich hohe Gebühren für Datenbankreplikationen verursachen.
Um die Größenbeschränkung aufzuheben, setzen Sie den Wert auf
0.0
.Beachten Sie, dass für nachfolgende Aktualisierungen einer Sekundärdatenbank derzeit keine Standardgrößenbeschränkung gilt.
- Werte:
0.0
und darüber mit einer Dezimalstellenzahl (scale) von mindestens 1 (z. B.20.5
,32.25
,33.333
usw.).- Standard:
10.0
JDBC_ENABLE_PUT_GET¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Beschreibung:
Legt fest, ob die Befehle PUT und GET Zugriff auf lokale Dateisysteme erhalten sollen.
- Werte:
TRUE
: JDBC aktiviert die Befehle PUT und GET.FALSE
: JDBC deaktiviert die Befehle PUT und GET.- Standard:
TRUE
JDBC_TREAT_DECIMAL_AS_INT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, wie JDBC Spalten verarbeitet, die eine Dezimalstellenzahl von null (
0
) haben.- Werte:
TRUE
: JDBC verarbeitet eine Spalte, deren Dezimalstellenzahl null ist, als BIGINT.FALSE
: JDBC verarbeitet eine Spalte, deren Dezimalstellenzahl null ist, als DECIMAL.- Standard:
TRUE
JDBC_TREAT_TIMESTAMP_NTZ_AS_UTC¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, wie JDBC TIMESTAMP_NTZ-Werte verarbeitet.
Wenn der JDBC-Treiber einen Wert des Typs TIMESTAMP_NTZ von Snowflake abruft, konvertiert der Treiber den Wert standardmäßig in die aufgewendete Zeit unter Verwendung der JVM-Zeitzone des Clients.
Benutzer, die bei der Konvertierung die Zeitzone UTC beibehalten möchten, können diesen Parameter auf
TRUE
setzen.Dieser Parameter gilt nur für den JDBC-Treiber.
- Werte:
TRUE
: Der Treiber verwendet UTC, um den TIMESTAMP_NTZ-Wert als aufgewendete Zeit zu erhalten.FALSE
: Der Treiber verwendet die aktuelle JVM-Zeitzone des Clients, um den TIMESTAMP_NTZ-Wert als aufgewendete Zeit zu erhalten.- Standard:
FALSE
JDBC_USE_SESSION_TIMEZONE¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob der JDBC-Treiber für die Methoden
getDate()
,getTime()
undgetTimestamp()
derResultSet
-Klasse die Zeitzone der JVM oder die Zeitzone der Sitzung (angegeben durch den Parameter TIMEZONE) verwendet.- Werte:
TRUE
: Der JDBC-Treiber verwendet die Zeitzone der Sitzung.FALSE
: Der JDBC-Treiber verwendet die Zeitzone der JVM.- Standard:
TRUE
JSON_INDENT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Ganzzahl (Integer)
- Beschreibung:
Gibt die Anzahl der Leerzeichen an, um die jedes neue Element in der JSON-Ausgabe in der Sitzung eingerückt wird. Gibt außerdem an, ob nach jedem Element Zeilenumbrüche eingefügt werden sollen.
- Werte:
0
bis16
(Der Wert
0
gibt eine kompakte Ausgabe zurück, indem alle Leerzeichen und Zeilenumbrüche aus der Ausgabe entfernt werden.)- Standard:
2
Bemerkung
Dieser Parameter wirkt sich nicht auf JSON-Ausgaben aus, die mit dem Befehl COPY INTO <Speicherort> aus einer Tabelle in eine Datei entladen werden. Der Befehl entlädt JSON-Daten immer im ndjson-Format:
Jeder Datensatz aus der Tabelle wird durch ein Zeilenumbruchzeichen getrennt.
Kompakte Formatierung innerhalb jedes Datensatzes (d. h. keine Leerzeichen oder Zeilenumbrüche).
JS_TREAT_INTEGER_AS_BIGINT¶
- Typ:
Sitzung – Kann für Sitzung festgelegt werden
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, wie der Snowflake-Node.js-Treiber numerische Spalten mit einer Dezimalstellenzahl von null (
0
) verarbeitet, z. B. INTEGER oder NUMBER(p, 0).- Werte:
TRUE
: JavaScript verarbeitet eine Spalte, deren Dezimalstellenzahl null ist, als BIGINT.FALSE
: JavaScript verarbeitet eine Spalte, deren Dezimalstellenzahl null ist, als NUMBER.- Standard:
FALSE
Bemerkung
Standardmäßig werden INTEGER-Spalten in Snowflake (einschließlich BIGINT, NUMBER(p, 0) usw.) in den JavaScript-Datentyp Zahl (Number) konvertiert. Die größten zulässigen Snowflake-Ganzzahlwerte sind jedoch größer als die größten zulässigen JavaScript-Zahlenwerte. Um Snowflake-INTEGER-Spalten in JavaScript Bigint zu konvertieren, in denen größere Werte als JavaScript Number gespeichert werden können, legen Sie den Sitzungsparameter JS_TREAT_INTEGER_AS_BIGINT fest.
Beispiele zur Verwendung dieses Parameters finden Sie unter Abrufen von Ganzzahl-Datentypen als Bigint.
LOCK_TIMEOUT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zahl
- Beschreibung:
Anzahl der Sekunden, die gewartet werden soll, während versucht wird, eine Ressource zu sperren, bevor das Zeitlimit überschritten und die Anweisung abgebrochen wird.
- Werte:
0
auf eine beliebige Zahl setzen (d. h. keine Begrenzung). Ein Wert von0
deaktiviert das Warten auf Sperren (d. h. die Anweisung muss die Sperre sofort erhalten oder abbrechen). Wenn mehrere Ressourcen durch die Anweisung gesperrt werden müssen, gilt das Timeout für jeden Sperrversuch separat- Standard:
43200
(d. h. 12 Stunden)
LOG_LEVEL¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Typ:
Objekt (für Datenbanken, Schemas, gespeicherte Prozeduren und UDFs) – Kann festgelegt werden für Konto » Datenbank » Schema » Prozedur und Konto » Datenbank » Schema » Funktion
- Datentyp:
Zeichenfolge (Konstante)
- Beschreibung:
Gibt den Schweregrad von Meldungen an, die in die aktive Ereignistabelle erfasst und zur Verfügung gestellt werden sollen. Meldungen des angegebenen Schweregrads (und mit höherem Schweregrad) werden erfasst. Weitere Informationen zu Protokolliergraden finden Sie unter Einstellen des Protokolliergrads.
- Werte:
TRACE
DEBUG
INFO
WARN
ERROR
FATAL
OFF
- Standard:
OFF
- Zusätzliche Anmerkungen:
In der folgenden Tabelle sind die Schweregrade der Meldungen aufgeführt, die erfasst werden, wenn Sie den Parameter
LOG_LEVEL
auf einen Schweregrad setzen.Einstellungen für den LOG_LEVEL-Parameter
Schweregrade von erfassten Meldungen
TRACE
TRACE
DEBUG
INFO
WARN
ERROR
FATAL
DEBUG
DEBUG
INFO
WARN
ERROR
FATAL
INFO
INFO
WARN
ERROR
FATAL
WARN
WARN
ERROR
FATAL
ERROR
ERROR
FATAL
FATAL
ERROR
(Nur für Java-UDFs, Java-UDTFs sowie gespeicherte Prozeduren in Java und Scala. Weitere Informationen dazu finden Sie unter Erläuterungen zum Protokolliergrad.)FATAL
Wenn dieser Parameter sowohl in der Sitzung als auch im Objekt (oder Schema, Datenbank, Konto) gesetzt ist, wird der Wert mit der größeren Ausführlichkeit verwendet. Siehe Erläuterungen zur Bestimmung des effektiven Protokolliergrads durch Snowflake.
MAX_CONCURRENCY_LEVEL¶
- Typ:
Objekt (für Warehouses) – Kann festgelegt werden für Konto » Warehouse
- Datentyp:
Zahl
- Beschreibung:
Gibt den Parallelitätsgrad für SQL-Anweisungen (Abfragen und DML) an, die von einem Warehouse ausgeführt werden. Wenn der Grad erreicht ist, hängt die ausgeführte Operation davon ab, ob es sich bei dem Warehouse um ein Einzel-Cluster-Warehouse oder ein Multi-Cluster-Warehouse handelt:
Einzelcluster oder Multi-Cluster (im Modus „Maximiert“): Anweisungen werden in die Warteschlange gestellt, bis bereits zugewiesene Ressourcen freigegeben oder zusätzliche Ressourcen bereitgestellt werden. Dies kann durch Vergrößern des Warehouse erreicht werden.
Multi-Cluster (im Modus „Automatische Skalierung“): Zusätzliche Cluster werden gestartet.
MAX_CONCURRENCY_LEVEL kann in Verbindung mit dem Parameter STATEMENT_QUEUED_TIMEOUT_IN_SECONDS verwendet werden, um sicherzustellen, dass ein Warehouse niemals in Rückstand gerät.
Im Allgemeinen ist die Anzahl der Anweisungen begrenzt, die von einem Warehouse-Cluster gleichzeitig ausgeführt werden können, aber es gibt auch Ausnahmen. Im folgenden Fall kann die tatsächliche Anzahl der Anweisungen, die gleichzeitig von einem Warehouse ausgeführt werden, über oder unter dem angegebenen Wert liegen:
Kleine, weniger komplexe Anweisungen: Mehr Anweisungen können gleichzeitig ausgeführt werden, da kleine, weniger komplexe Anweisungen im Allgemeinen auf einer Teilmenge der Computeressourcen eines Warehouses ausgeführt werden. Dies bedeutet, dass sie nur mit einem Bruchteil in den Parallelitätsgrad eingehen.
Größere, komplexere Anweisungen: Es werden möglicherweise weniger Anweisungen gleichzeitig ausgeführt.
- Standard:
8
Tipp
Dieser Wert ist nur ein Standardwert und kann jederzeit verändert werden:
Durch Herabsetzen des Parallelitätsgrads eines Warehouses kann die Anzahl der gleichzeitig ausgeführten Abfragen in einem Warehouse begrenzt werden. Wenn zu einem bestimmten Zeitpunkt weniger Abfragen um die Ressourcen des Warehouses konkurrieren, können einer Abfrage potenziell mehr Ressourcen zugewiesen werden, was zu einer schnelleren Verarbeitung der Abfrage führen kann, insbesondere bei großen/komplexen Abfragen mit mehreren Anweisungen.
Durch Erhöhen des Parallelitätsgrads eines Warehouses kann dazu führen, dass für eine Anweisung weniger Computeressourcen zur Verfügung stehen. Dadurch wird die Anzahl der gleichzeitigen Abfragen, die vom Warehouse ausgeführt werden können, jedoch nicht immer begrenzt. Dies hat auch nicht notwendigerweise Einfluss auf die gesamte Warehouse-Performance, die von der Art der ausgeführten Abfragen abhängt.
Beachten Sie, dass sich dieser Parameter, wie zuvor beschrieben, auf Multi-Cluster-Warehouses auswirkt (im Modus „Automatische Skalierung“), da Snowflake automatisch einen neuen Cluster im Multi-Cluster-Warehouse startet, um die Warteschlange zu vermeiden. Wenn Sie den Parallelitätsgrad für ein Warehouse mit mehreren Clustern (im Modus „Automatische Skalierung“) verringern, erhöht sich dadurch möglicherweise jederzeit die Anzahl der aktiven Cluster.
Denken Sie auch daran, dass Snowflake bei der Übermittlung der Anweisungen automatisch Ressourcen zuweist und die zugewiesene Menge von den individuellen Anforderungen der Anweisung bestimmt wird. Auf dieser Grundlage und unter Verwendung unserer Beobachtungen von Benutzerabfragemustern haben wir einen Standard ausgewählt, der Leistung und Ressourcennutzung in Einklang bringt.
Wir empfehlen daher, vor dem Ändern der Standardeinstellung die Änderung zu testen, indem Sie den Parameter in kleinen Schritten anpassen und die Auswirkung auf einen repräsentativen Satz Ihrer Abfragen beobachten.
MAX_DATA_EXTENSION_TIME_IN_DAYS¶
- Typ:
Objekt (für Datenbanken, Schemas und Tabellen) – Kann festgelegt werden für Konto » Datenbank » Schema » Tabelle
- Datentyp:
Ganzzahl (Integer)
- Beschreibung:
Maximale Anzahl von Tagen, für die Snowflake die Datenaufbewahrungsfrist für Tabellen verlängern kann, um zu verhindern, dass Streams auf den Tabellen veralten. Wenn die DATA_RETENTION_TIME_IN_DAYS-Einstellung für eine Quelltabelle weniger als 14 Tage beträgt und kein Stream verbraucht wurde, verlängert Snowflake standardmäßig diese Frist vorübergehend bis zum Offset des Streams um maximal 14 Tage, unabhängig von der Snowflake-Edition Ihres Kontos. Der MAX_DATA_EXTENSION_TIME_IN_DAYS-Parameter ermöglicht eine Begrenzung dieser automatischen Verlängerungsfrist, um die Speicherkosten für die Datenaufbewahrung zu kontrollieren oder aus Gründen der Compliance.
Der Parameter kann auf Konto-, Datenbank-, Schema- oder Tabellenebene festgelegt werden. Beachten Sie, dass sich das Festlegen des Parameters auf der Konto- oder Schemaebene nur auf Tabellen auswirkt, für die der Parameter noch nicht explizit auf einer niedrigeren Ebene festgelegt wurde (z. B. auf der Tabellen-Ebene vom Tabellen-Eigentümer). Der Wert 0
deaktiviert die automatische Verlängerung für die angegebene Datenbank, das angegebene Schema oder die angegebene Tabelle. Weitere Informationen zu Streams und zum Veralten finden Sie unter Änderungsnachverfolgung mit Tabellenstreams.
- Werte:
0
bis90
(d. h. 90 Tage). Ein Wert von0
deaktiviert die automatische Verlängerung der Datenaufbewahrungsfrist. Um den Maximalwert für Tabellen Ihres Kontos zu erhöhen, wenden Sie sich an den Snowflake-Support.- Standard:
14
Bemerkung
Dieser Parameter kann dazu führen, dass Daten länger als die Standard-Datenaufbewahrungsfrist aufbewahrt werden. Prüfen Sie vor dem Erhöhen des Werts, ob der neue Wert Ihren Compliance-Anforderungen gerecht wird.
MULTI_STATEMENT_COUNT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Ganzzahl (Konstante)
- Clients:
SQL-API, JDBC, .NET, ODBC
- Beschreibung:
Anzahl der Anweisungen, die ausgeführt werden sollen, wenn die Funktion für mehrere Anweisungen verwendet wird.
- Werte:
0
: variable Anzahl von Anweisungen.1
: eine Anweisung.Größer als
1
: Wenn MULTI_STATEMENT_COUNT als Sitzungsparameter festgelegt ist, können Sie die genaue Anzahl der auszuführenden Anweisungen angeben.Negative Zahlen sind nicht erlaubt.
- Standard:
1
MIN_DATA_RETENTION_TIME_IN_DAYS¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Ganzzahl (Integer)
- Beschreibung:
Minimale Anzahl der Tage, für die Snowflake historische Daten zu einem Objekt zur Durchführung von Time Travel-Aktionen (SELECT, CLONE, UNDROP) aufbewahrt. Wenn für ein Konto eine minimale Anzahl von Tagen für die Datenaufbewahrung festgelegt ist, wird die Datenaufbewahrungsfrist eines Objekts durch MAX(DATA_RETENTION_TIME_IN_DAYS, MIN_DATA_RETENTION_TIME_IN_DAYS) bestimmt.
Weitere Informationen dazu finden Sie unter Verstehen und Verwenden von Time Travel.
- Werte:
0
oder1
(für Standard Edition)0
bis90
(für Enterprise Edition oder höher)- Standard:
0
Bemerkung
Dieser Parameter gilt nur für permanente Tabellen und nicht für die folgenden Objekte:
Transiente Tabellen
Temporäre Tabellen
Externe Tabellen
Materialisierte Ansichten
Streams
Dieser Parameter kann nur von Kontoadministratoren (d. h. Benutzern mit der Rolle ACCOUNTADMIN oder einer anderen Rolle, der die Rolle ACCOUNTADMIN zugewiesen ist) festgelegt oder aufgehoben werden.
Die Einstellung der minimalen Datenaufbewahrungsdauer hat keine Auswirkungen auf den für Datenbanken, Schemas oder Tabellen festgelegten Parameterwert für DATA_RETENTION_TIME_IN_DAYS. Die geltende Aufbewahrungsdauer einer Datenbank, eines Schemas oder einer Tabelle ist MAX(DATA_RETENTION_TIME_IN_DAYS, MIN_DATA_RETENTION_TIME_IN_DAYS).
NETWORK_POLICY¶
- Typ:
Konto – Kann nur für Konto festgelegt werden (von Kontoadministratoren und auch von Systemadministratoren)
- Typ:
Objekt (für Benutzer) – Kann für Konto » Benutzer festgelegt werden
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt die Netzwerkrichtlinie an, die für Ihr Konto durchgesetzt werden soll. Netzwerkrichtlinien ermöglichen die Beschränkung des Zugriffs auf Ihr Konto basierend auf der IP-Adresse der Benutzer. Weitere Details dazu finden Sie unter Steuern des Netzwerkdatenverkehrs mit Netzwerkrichtlinien.
- Werte:
Eine vorhandene Netzwerkrichtlinie (erstellt mit CREATE NETWORK POLICY)
- Standard:
Keine
Bemerkung
Dies ist der einzige Kontoparameter, der von Sicherheitsadministratoren (d. h. Benutzer mit der Rolle SECURITYADMIN) oder höher festgelegt werden kann.
NOORDER_SEQUENCE_AS_DEFAULT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob die Eigenschaft ORDER oder NOORDER standardmäßig festgelegt wird, wenn Sie eine neue Sequenz erstellen oder eine neue Tabellenspalte hinzufügen.
Die Eigenschaften ORDER und NOORDER bestimmen, ob die Werte für die Sequenz oder für die automatisch inkrementierte Spalte in aufsteigender oder absteigender Reihenfolge generiert werden sollen oder nicht.
- Werte:
TRUE
: Wenn Sie eine neue Sequenz erstellen oder eine neue Tabellenspalte hinzufügen, ist die Eigenschaft NOORDER standardmäßig festgelegt.NOORDER gibt an, dass nicht garantiert ist, dass die Werte in aufsteigender Reihenfolge sind.
Wenn beispielsweise eine Sequenz die Werte START 1 INCREMENT 2 hat, könnten die generierten Werte
1
,3
,101
,5
,103
usw. sein.NOORDER kann die Leistung verbessern, wenn mehrere Einfügeoperationen gleichzeitig ausgeführt werden müssen (z. B. wenn mehrere Clients mehrere INSERT-Anweisungen ausführen).
FALSE
: Wenn Sie eine neue Sequenz erstellen oder eine neue Tabellenspalte hinzufügen, ist die Eigenschaft ORDER standardmäßig festgelegt.ORDER gibt an, dass die Werte, die für eine Sequenz oder eine automatisch inkrementierte Spalte generiert werden, in aufsteigender Reihenfolge sind (oder, wenn das Intervall einen negativen Wert hat, in abnehmender Reihenfolge).
Wenn beispielsweise eine Sequenz oder eine automatisch inkrementierte Spalte die Werte START 1 INCREMENT 2 hat, könnten die generierten Werte
1
,3
,5
,7
,9
usw. sein.
Wenn Sie diesen Parameter festlegen, überschreibt dieser Wert den Wert im Verhaltensänderungs-Bundle 2024_01.
- Standard:
TRUE
ODBC_TREAT_DECIMAL_AS_INT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, wie ODBC Spalten verarbeitet, die eine Dezimalstellenzahl von null (
0
) haben.- Werte:
TRUE
: ODBC verarbeitet eine Spalte, deren Dezimalstellenzahl null ist, als BIGINT.FALSE
: ODBC verarbeitet eine Spalte, deren Dezimalstellenzahl null ist, als DECIMAL.- Standard:
FALSE
OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Boolesch
- Beschreibung:
Bestimmt, ob die Rollen ACCOUNTADMIN, ORGADMIN und SECURITYADMIN als Primärrolle verwendet werden können, wenn eine Snowflake-Sitzung auf Basis des Zugriffstokens vom Snowflake-Autorisierungsserver erstellt wird.
- Werte:
TRUE
: Fügt die Rollen ACCOUNTADMIN, ORGADMIN und SECURITYADMIN der EigenschaftBLOCKED_ROLES_LIST
der Snowflake OAuth-Sicherheitsintegration hinzu, was bedeutet, dass diese Rollen beim Erstellen einer Snowflake-Sitzung mit Snowflake OAuth nicht als Primärrolle verwendet werden können.FALSE
: Entfernt ACCOUNTADMIN, ORGADMIN und SECURITYADMIN aus der Liste der gesperrten Rollen, die durch die EigenschaftBLOCKED_ROLES_LIST
der Snowflake OAuth-Sicherheitsintegration definiert sind.- Standard:
TRUE
PERIODIC_DATA_REKEYING¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Boolesch
- Beschreibung:
Dieser Parameter gilt nur für Enterprise Edition (oder höher). Er aktiviert/deaktiviert die Neuverschlüsselung von Tabellendaten mit neuen Schlüsseln auf jährlicher Basis, um zusätzlichen Datenschutz zu bieten.
Sie können die Wiederverschlüsselung jederzeit aktivieren und deaktivieren. Das Aktivieren/Deaktivieren der Wiederverschlüsselung führt nicht zu Lücken in den verschlüsselten Daten:
Wenn die Wiederverschlüsselung für einen bestimmten Zeitraum aktiviert ist und dann deaktiviert wird, werden alle Daten, die bereits für die Wiederverschlüsselung markiert wurden, erneut verschlüsselt. Weitere Daten werden jedoch erst wieder neu verschlüsselt, wenn Sie die Wiederverschlüsselung wieder aktivieren.
Wenn die Wiederverschlüsselung wieder aktiviert wird, werden alle Daten, deren Schlüssel die Kriterien erfüllen (d. h. der Schlüssel ist älter als ein Jahr), automatisch von Snowflake neu verschlüsselt.
Weitere Informationen zur Wiederverschlüsselung verschlüsselter Daten finden Sie unter Hinweise zur Verwaltung von Verschlüsselungsschlüsseln in Snowflake.
- Werte:
TRUE
: Die Daten werden ein Jahr nach der letzten Verschlüsselung neu verschlüsselt. Die Wiederverschlüsselung erfolgt im Hintergrund, sodass keine Ausfallzeiten auftreten und die betroffenen Daten/Tabellen immer verfügbar sind.FALSE
: Daten werden nicht neu verschlüsselt.- Standard:
FALSE
Bemerkung
Mit der Wiederverschlüsselung von Daten sind Gebühren verbunden, da nach der Wiederverschlüsselung die alten Daten (mit der vorherigen Verschlüsselung) für den Standardzeitraum (7 Tage) in Fail-safe aufbewahrt werden. Aus diesem Grund ist die periodische Wiederverschlüsselung standardmäßig deaktiviert. Um die periodische Wiederverschlüsselung zu aktivieren, müssen Sie sie explizit aktivieren.
Außerdem werden Fail-safe-Gebühren für die Wiederverschlüsselung in Ihrer monatlichen Abrechnung nicht einzeln aufgeführt. Sie sind jeden Monat in der Fail-safe-Gesamtsumme für Ihr Konto enthalten.
Weitere Informationen zu Fail-safe finden Sie unter Erläuterungen zu und Anzeigen von Fail-safe.
PIPE_EXECUTION_PAUSED¶
- Typ:
Objekt – Kann festgelegt werden für Konto » Schema » Pipe
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob eine laufende Pipe angehalten werden soll, besonders in Vorbereitung auf die Übertragung der Eigentümerschaft der Pipe auf eine andere Rolle:
Ein Kontoadministrator (Benutzer mit der Rolle ACCOUNTADMIN) kann diesen Parameter auf Kontoebene festlegen, um alle Pipes im Konto effektiv anzuhalten oder fortzusetzen.
Ein Benutzer mit der Berechtigung MODIFY für ein Schema kann alle Pipes in dem Schema anhalten oder fortsetzen.
Der Pipeinhaber kann diesen Parameter für eine Pipe festlegen.
Beachten Sie, dass das Festlegen des Parameters auf der Konto- oder Schemaebene nur für Pipes gilt, für die der Parameter noch nicht explizit auf einer niedrigeren Ebene festgelegt wurde (z. B. auf der Pipe-Ebene vom Pipe-Eigentümer).
Dies ermöglicht den praktischen Anwendungsfall, bei dem ein Kontoadministrator alle Pipes auf Kontoebene anhalten kann, ein Pipe-Eigentümer aber dennoch eine eigene Pipe ausführen kann.
- Werte:
TRUE
: Hält die Pipe an. Wenn der Parameter auf diesen Wert gesetzt ist, zeigt die Funktion SYSTEM$PIPE_STATUS denexecutionState
alsPAUSED
an. Beachten Sie, dass der Pipe-Eigentümer zwar weiterhin Dateien an eine angehaltene Pipe übermitteln kann, die Dateien jedoch erst nach Fortsetzung der Pipe verarbeitet.FALSE
: Setzt die Pipe fort, jedoch nur, wenn die Eigentümerschaft der Pipe nicht übertragen wurde, während sie angehalten war. Wenn der Parameter auf diesen Wert gesetzt ist, zeigt die Funktion SYSTEM$PIPE_STATUS denexecutionState
alsRUNNING
an.Wenn die Eigentümerschaft der Pipe nach dem Anhalten der Pipe auf eine andere Rolle übertragen wurde, kann dieser Parameter nicht zum Fortsetzen der Pipe verwendet werden. Verwenden Sie stattdessen die Funktion SYSTEM$PIPE_FORCE_RESUME, um ein Fortsetzen der Pipe durchzusetzen.
Dies ermöglicht es dem neuen Eigentümer, den Pipestatus (z. B. wie viele Dateien darauf warten, geladen zu werden) mit SYSTEM$PIPE_STATUS zu bewerten, bevor er die Pipe fortsetzt.
- Standard:
FALSE
(Pipes werden standardmäßig ausgeführt)
Bemerkung
Im Allgemeinen müssen Pipes nicht angehalten werden, außer für die Übertragung der Eigentümerschaft.
PREVENT_UNLOAD_TO_INLINE_URL¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob Ad-hoc-Operationen zum Entladen von Daten an externe Cloudspeicherorte verhindert werden sollen (d. h. COPY INTO <Speicherort>-Anweisungen, die die Cloudspeicher-URL angeben und direkt in der Anweisung auf Einstellungen zugreifen). Ein Beispiel dazu finden Sie unter Entladen von Daten aus einer Tabelle direkt in Dateien an einem externen Speicherort.
- Werte:
TRUE
: COPY INTO <Speicherort>-Anweisungen müssen entweder auf einen benannten internen (Snowflake) oder externen Stagingbereich oder auf einen internen Benutzer- oder Tabellen-Stagingbereich verweisen. Ein benannter externer Stagingbereich muss die Cloudspeicher-URL und die Zugriffseinstellungen in seiner Definition speichern.FALSE
: Ad-hoc-Datenentladeoperationen an externe Cloudspeicherorte sind zulässig.- Standard:
FALSE
PREVENT_UNLOAD_TO_INTERNAL_STAGES¶
- Typ:
Benutzer – Kann für Konto » Benutzer festgelegt werden
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob Datenentladeoperationen zu internen (Snowflake) Stagingbereichen mit COPY INTO <Speicherort>-Anweisungen verhindert werden sollen.
- Werte:
TRUE
: Daten werden aus Snowflake-Tabellen in einen internen Stagingbereich entladen, einschließlich Benutzer-, Tabellen- oder benannte interne Stagingbereiche.FALSE
: Daten werden in interne Stagingbereiche entladen, wobei nur die Standardeinschränkungen des Stagingbereichtyps gelten:Der aktuelle Benutzer kann Daten nur in seinen eigenen Benutzer-Stagingbereich entladen.
Benutzer können nur dann Daten in Tabellen-Stagingbereiche entladen, wenn ihre aktive Rolle die OWNERSHIP-Berechtigung für die Tabelle hat.
Benutzer können nur dann Daten in benannte interne Stagingbereiche entladen, wenn ihre aktive Rolle die WRITE-Berechtigung für den Stagingbereich hat.
- Standard:
FALSE
QUERY_TAG¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (bis zu 2.000 Zeichen)
- Beschreibung:
Optionale Zeichenfolge, die zum Markieren von Abfragen und anderen SQL-Anweisungen verwendet werden kann, die innerhalb einer Sitzung ausgeführt werden. Die Tags werden in der Ausgabe der Funktionen QUERY_HISTORY , QUERY_HISTORY_BY_* angezeigt.
- Standard:
Keine
QUOTED_IDENTIFIERS_IGNORE_CASE¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
Objekt – Kann festgelegt werden für Konto » Datenbank » Schema » Tabelle
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob Buchstaben in Objektbezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, als Großbuchstaben gespeichert und aufgelöst werden sollen. Standardmäßig behält Snowflake beim Speichern und Auflösen von Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, die Groß-/Kleinschreibung von alphabetischen Zeichen bei (siehe Auflösung des Bezeichners). Sie können diesen Parameter in Situationen verwenden, in denen Drittanbieteranwendungen immer doppelte Anführungszeichen um Bezeichner verwenden.
Bemerkung
Das Ändern des Standardwerts dieses Parameters kann sich auf die Fähigkeit auswirken, Objekte zu finden, die zuvor mit Bezeichnern in doppelten Anführungszeichen und gemischter Groß-/Kleinschreibung erstellt wurden. Weitere Informationen dazu finden Sie unter Auswirkungen der Änderung des Parameters.
Wenn die Einstellung für eine Tabelle, ein Schema oder eine Datenbank festgelegt wurde, wirkt sie sich nur auf die Auswertung von Tabellennamen in den Textteilen von Ansichten und benutzerdefinierten Funktionen (UDFs) aus. Wenn Ihr Konto Bezeichner in doppelten Anführungszeichen verwendet, bei denen die Groß-/Kleinschreibung nicht beachtet werden soll, und Sie planen, eine Ansicht oder UDF für ein Konto freizugeben, bei dem bei Bezeichnern in doppelten Anführungszeichen die Groß-/Kleinschreibung beachtet wird, können Sie dies in der freizugebenden Ansicht oder UDF einstellen. Dadurch kann das andere Konto die Tabellennamen in der Ansicht oder UDF korrekt auflösen.
- Werte:
TRUE
: Buchstaben in Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, werden als Großbuchstaben gespeichert und aufgelöst.FALSE
: Die Groß-/Kleinschreibung der Buchstaben in Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, wird beibehalten. Snowflake löst die Bezeichner auf und speichert sie in der angegebenen Schreibweise.Weitere Informationen dazu finden Sie unter Auflösung des Bezeichners.
- Standard:
FALSE
Beispiel:
Bezeichner |
Parameter auf |
Parameter auf |
|
---|---|---|---|
|
wird aufgelöst in: |
|
|
|
wird aufgelöst in: |
|
|
|
wird aufgelöst in: |
|
|
|
wird aufgelöst in: |
|
|
REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_CREATION¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob beim Erstellen eines benannten externen Stagingbereichs (mit CREATE STAGE) für den Zugriff auf einen privaten Cloudspeicherort ein Speicherintegrationsobjekt als Cloudanmeldeinformation erforderlich ist.
- Werte:
TRUE
: Um einen externen Stagingbereich für den Zugriff auf einen privaten Cloudspeicherort zu erstellen, muss ein Speicherintegrationsobjekt als Cloudanmeldeinformation referenziert werden.FALSE
: Zum Erstellen eines externen Stagingbereichs ist kein Verweis auf ein Speicherintegrationsobjekt erforderlich. Benutzer können stattdessen auf explizite Anmeldeinformationen des Cloudanbieters verweisen, z. B. geheime Schlüssel oder Zugriffstoken, falls diese für den Speicherort konfiguriert wurden.- Standard:
FALSE
REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_OPERATION¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob beim Laden/Entladen von Daten von/in private Cloudspeicherorte die Verwendung eines benannten externen Stagingbereichs erforderlich ist, der auf ein Speicherintegrationsobjekt als Cloudanmeldeinformation verweist.
- Werte:
TRUE
: Das Laden von Daten von oder das Entladen von Daten in private Cloudspeicherorte erfordert die Verwendung eines benannten externen Stagingbereichs, der auf ein Speicherintegrationsobjekt verweist. Die Angabe eines benannten externen Stagingbereichs, der auf explizite Anmeldeinformationen des Cloudanbieters verweist, z. B. geheime Schlüssel oder Zugriffstoken, führt zu einem Benutzerfehler.FALSE
: Benutzer können Daten von/in private Cloudspeicherorte laden/entladen, indem sie einen benannten externen Stagingbereich verwenden, der auf explizite Anmeldeinformationen des Cloudanbieters verweist.Wenn PREVENT_UNLOAD_TO_INLINE_URL FALSE ist, können Benutzer die expliziten Anmeldeinformationen des Cloudanbieters direkt in der COPY-Anweisung angeben.
- Standard:
FALSE
ROWS_PER_RESULTSET¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zahl
- Clients:
SQL API
- Beschreibung:
Gibt die maximale Anzahl von Zeilen an, die in einem Resultset zurückgegeben werden.
- Werte:
0
bis zu einer beliebigen Zahl (d. h. keine Begrenzung) – der Wert0
gibt kein Maximum an.- Standard:
0
S3_STAGE_VPCE_DNS_NAME¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt den DNS-Namen eines Amazon S3-Schnittstellenendpunkts an. Anfragen, die über AWS PrivateLink für Amazon S3 an den internen Stagingbereich eines Kontos gesendet werden, verwenden diesen Endpunkt zur Verbindung.
Weitere Informationen dazu finden Sie unter Zugriff auf interne Stagingbereiche mit dedizierten Schnittstellenendpunkten.
- Werte:
Gültiger regionalspezifischer DNS-Name eines S3-Schnittstellenendpunkts.
Das Standardformat beginnt mit einem Sternchen (
*
) und endet mitvpce.amazonaws.com
(z. B.*.vpce-sd98fs0d9f8g.s3.us-west-2.vpce.amazonaws.com
). Weitere Einzelheiten zur Ermittlung dieses Wertes finden Sie unter AWS-Konfiguration.Alternative Formate sind
bucket.vpce-xxxxxxxx.s3.<region>.vpce.amazonaws.com
undvpce-xxxxxxxx.s3.<region>.vpce.amazonaws.com
.- Standard:
Leere Zeichenfolge
SAML_IDENTITY_PROVIDER¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
JSON
- Beschreibung:
Aktiviert die Verbundauthentifizierung. Dieser veraltete Parameter ermöglicht eine Verbundauthentifizierung. Dieser Parameter akzeptiert ein JSON-Objekt, das in einfache Anführungszeichen eingeschlossen ist, mit den folgenden Feldern:
{ "certificate": "", "issuer": "", "ssoUrl": "", "type" : "", "label" : "" }
Wobei:
certificate
Gibt das Zertifikat an (generiert vom IdP), das die Kommunikation zwischen dem IdP und Snowflake überprüft.
issuer
Zeigt den Aussteller bzw. die EntityID des IdP an.
Optional.
Informationen darüber, wie Sie diesen Wert in Okta und AD FS erhalten, finden Sie unter Migration zu einer SAML2-Sicherheitsintegration.
ssoUrl
Gibt den URL-Endpunkt an (bereitgestellt vom IdP), an den Snowflake die SAML-Anfragen sendet.
type
Gibt den IdP-Typ an, der für die Verbundauthentifizierung verwendet wird (
"OKTA"
,"ADFS"
,"Custom"
).label
Gibt den Text der Schaltfläche für den IdP auf der Anmeldeseite von Snowflake an. Die Standardbezeichnung lautet
Single Sign On
. Wenn Sie die Standardbezeichnung ändern, darf die von Ihnen angegebene Bezeichnung nur alphanumerische Zeichen enthalten (d. h. Sonderzeichen und Leerzeichen werden derzeit nicht unterstützt).Wenn das Feld
"type"
"Okta"
ist, muss kein Wert für das Feldlabel
angegeben werden, da Snowflake das Okta-Logo in der Schaltfläche anzeigt.
Weitere Informationen sowie Beispiele zum Festlegen des Parameters finden Sie unter Migration zu einer SAML2-Sicherheitsintegration.
- Standard:
Keine
SEARCH_PATH¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt den zu suchenden Pfad an, um unqualifizierte Objektnamen in Abfragen aufzulösen. Weitere Informationen dazu finden Sie unter Namensauflösung in Abfragen.
- Werte:
Kommagetrennte Liste von Bezeichnern. Ein Bezeichner kann ein vollständig oder teilweise qualifizierter Schemaname sein.
- Standard:
$current, $public
Weitere Informationen zu den Standardeinstellungen finden Sie unter Standardsuchpfad.
SIMULATED_DATA_SHARING_CONSUMER¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt den Namen eines Verbraucherkontos an, das zum Testen/Validieren von gemeinsam genutzten Daten, insbesondere von gemeinsam genutzten gesicherten Ansichten, simuliert werden soll. Wenn dieser Parameter in einer Sitzung festgelegt ist, geben freigegebene Ansichten Zeilen so zurück, als wären sie im angegebenen Verbraucherkonto ausgeführt worden und nicht im Anbieterkonto.
Bemerkung
Simulationen sind nur dann erfolgreich, wenn die aktuelle Rolle der Eigentümer der Ansicht ist. Wenn die aktuelle Rolle nicht Eigentümer der Ansicht ist, schlägt die Simulation mit folgendem Fehler fehl:
Shared view consumer simulation requires that the executing role owns the view.
Weitere Informationen dazu finden Sie unter Einführung in Secure Data Sharing und Verwenden von Freigaben.
- Standard:
Keine
Wichtig
Dies ist ein Sitzungsparameter, d. h. er kann auf Kontoebene festgelegt werden. Dies gilt jedoch nur für das Testen von Abfragen bei gemeinsamen Ansichten. Da sich der Parameter auf alle Abfragen in einer Sitzung auswirkt, sollte er niemals auf der Kontoebene festgelegt werden.
SSO_LOGIN_PAGE¶
- Typ:
Konto – Kann nur für Konto festgelegt werden
- Datentyp:
Boolesch
- Beschreibung:
Dieser veraltete Parameter deaktiviert den Vorschaumodus für das Testen von SSO (nach Aktivierung der Verbundauthentifizierung), bevor das Rollout der Funktion an die Benutzer erfolgt:
- Werte:
TRUE
: Der Vorschaumodus ist deaktiviert. Dem Benutzer wird auf der Snowflake-Hauptanmeldeseite die Schaltfläche für von Snowflake initiiertes SSO Ihres Identitätsanbieters (wie in SAML_IDENTITY_PROVIDER angegeben) angezeigt.FALSE
: Der Vorschaumodus ist aktiviert, und SSO kann mit der folgenden URL getestet werden:Wenn sich Ihr Konto in US West befindet:
https://<Kontobezeichner>.snowflakecomputing.com/console/login?fedpreview=true
Wenn sich Ihr Konto in einer anderen Region befindet:
https://<Kontobezeichner>.<Regions-ID>.snowflakecomputing.com/console/login?fedpreview=true
Weitere Informationen dazu finden Sie unter:
- Standard:
FALSE
STATEMENT_QUEUED_TIMEOUT_IN_SECONDS¶
- Typ:
Sitzung und Objekt (für Warehouses)
Kann für Konto » Benutzer » Sitzung festgelegt werden; kann auch für einzelne Warehouses festgelegt werden
- Datentyp:
Zahl
- Beschreibung:
Zeitdauer in Sekunden, die eine SQL-Anweisung (Abfrage, DDL, DML usw.) für ein Warehouse in der Warteschlange verbleibt, bevor sie vom System abgebrochen wird. Dieser Parameter kann zusammen mit dem Parameter MAX_CONCURRENCY_LEVEL verwendet werden, um sicherzustellen, dass ein Warehouse niemals zurückgestellt wird.
Der Parameter kann innerhalb der Sitzungshierarchie festgelegt werden. Er kann auch so festgelegt werden, dass ein Warehouse das Warteschlangen-Timeout für alle SQL-Anweisungen steuert, die vom Warehouse verarbeitet werden. Wenn der Parameter sowohl für ein Warehouse als auch für eine Sitzung festgelegt ist, wird der niedrigste Nicht-Null-Wert durchgesetzt. Beispiel:
Ein Warehouse hat ein Timeout von 120 Sekunden in der Warteschlange.
Das Zeitlimit für die Sitzung in der Warteschlange ist auf 60 Sekunden festgelegt.
Das Sitzungstimeout hat Vorrang (d. h. alle in der Sitzung übermittelten Anweisungen werden nach 60 Sekunden warten in der Warteschlange abgebrochen).
Bemerkung
Bei Ausführung von Aufgaben hat der Aufgabenparameter USER_TASK_TIMEOUT_MS Vorrang vor der Einstellung STATEMENT_QUEUED_TIMEOUT_IN_SECONDS.
Beim Vergleich der Werte dieser beiden Parameter ist zu beachten, dass STATEMENT_QUEUED_TIMEOUT_IN_SECONDS in Einheiten von Sekunden und USER_TASK_TIMEOUT_MS in Einheiten von Millisekunden angegeben wird.
Weitere Informationen zu USER_TASK_TIMEOUT_MS finden Sie im Abschnitt Optionale Parameter von CREATE TASK.
- Werte:
0
bis zu einer beliebigen Zahl (d. h. keine Begrenzung) – der Wert0
gibt an, dass kein Timeout erzwungen wird. Eine Anweisung verbleibt in der Warteschlange, solange die Warteschlange bestehen bleibt.- Standard:
0
(d. h. kein Timeout)
STATEMENT_TIMEOUT_IN_SECONDS¶
- Typ:
Sitzung und Objekt (für Warehouses)
Kann für Konto » Benutzer » Sitzung festgelegt werden; kann auch für einzelne Warehouses festgelegt werden
- Datentyp:
Zahl
- Beschreibung:
Zeitdauer in Sekunden, nach der eine laufende SQL-Anweisung (Abfrage, DDL, DML usw.) vom System abgebrochen wird.
Der Parameter kann innerhalb der Sitzungshierarchie festgelegt werden. Er kann auch so festgelegt werden, dass ein einzelnes Warehouse die Laufzeit aller SQL-Anweisungen steuert, die vom Warehouse verarbeitet werden. Wenn der Parameter sowohl für ein Warehouse als auch für eine Sitzung festgelegt ist, wird der niedrigste Nicht-Null-Wert durchgesetzt. Beispiel:
Ein Warehouse hat ein Timeout von 1.000 Sekunden.
Das Timeout für die Sitzung ist auf 500 Sekunden festgelegt.
Das Sitzungstimeout hat Vorrang (d. h. jede in der Sitzung übermittelte Anweisung wird abgebrochen, nachdem sie länger als 500 Sekunden ausgeführt wurde).
Bemerkung
Für die Ausführung von Aufgaben gilt Folgendes:
Wenn eine Aufgabe für ihre Computeressourcen auf ein virtuelles Warehouse angewiesen ist und STATEMENT_TIMEOUT_IN_SECONDS auf Warehouse-Ebene festgelegt wird, dann ist das effektive Timeout der kleinere der folgenden Parameter:
STATEMENT_TIMEOUT_IN_SECONDS
USER_TASK_TIMEOUT_MS (für Aufgabe festgelegter Parameter)
Andernfalls hat der Aufgabenparameter USER_TASK_TIMEOUT_MS Vorrang vor der Einstellung von STATEMENT_TIMEOUT_IN_SECONDS für Aufgabenausführungen.
Beim Vergleich der Werte dieser beiden Parameter ist zu beachten, dass STATEMENT_TIMEOUT_IN_SECONDS in Einheiten von Sekunden und USER_TASK_TIMEOUT_MS in Einheiten von Millisekunden angegeben wird.
Weitere Informationen zu USER_TASK_TIMEOUT_MS finden Sie im Abschnitt Optionale Parameter von CREATE TASK.
- Werte:
0
bis604800
(d. h. 7 Tage) – der Wert0
gibt an, dass der maximale Timeout-Wert erzwungen wird.- Standard:
172800
(d. h. 2 Tage)
STRICT_JSON_OUTPUT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Beschreibung:
Dieser Parameter gibt an, ob die JSON-Ausgabe in einer Sitzung mit dem allgemeinen Standard kompatibel ist (wie auf http://json.org beschrieben).
Snowflake erlaubt standardmäßig JSON-Eingaben, die nicht standardmäßige Werte enthalten. Diese nicht standardmäßigen Werte können jedoch dazu führen, dass Snowflake JSON ausgibt, das mit anderen Plattformen und Sprachen nicht kompatibel ist. Wenn dieser Parameter aktiviert ist, wird sichergestellt, dass die JSON-Ausgabe von Snowflake gültig/kompatibel ist.
- Werte:
TRUE
: Die strikte JSON-Ausgabe ist aktiviert und setzt folgendes Verhalten durch:Fehlende und undefinierte Werte in der Eingabe werden JSON NULL zugeordnet.
Unendliche numerische Werte in der Eingabe (Infinity, -Infinity, NaN usw.), werden Zeichenfolgen mit gültigen JavaScript-Darstellungen zugeordnet. Dies ermöglicht die Kompatibilität mit JavaScript und die Umwandlung dieser Werte in numerische Werte.
FALSE
: Die strikte JSON-Ausgabe ist nicht aktiviert.- Standard:
FALSE
Beispiel:
Nicht standardmäßige JSON-Eingabe |
Parameter auf |
Parameter auf |
|
---|---|---|---|
|
Ausgaben: |
|
|
|
Ausgaben: |
|
|
|
Ausgaben: |
|
|
|
Ausgaben: |
|
|
SUSPEND_TASK_AFTER_NUM_FAILURES¶
- Typ:
Objekt (für Datenbanken, Schemas und Aufgaben) – Kann festgelegt werden für Konto » Datenbank » Schema » Aufgabe
- Datentyp:
Ganzzahl (Integer)
- Beschreibung:
Anzahl der nacheinander fehlgeschlagenen Aufgabenausführungen, nach denen eine eigenständige Aufgabe oder die Stammaufgabe eines Task-Graphen automatisch angehalten wird. Zu den fehlgeschlagenen Aufgabenausführungen zählen solche, bei denen der SQL-Code im Textteil der Aufgabe entweder zu einem Benutzerfehler oder zu einem Timeout führt. Aufgabenausführungen, die übersprungen oder abgebrochen werden oder aufgrund eines Systemfehlers fehlschlagen, gelten als „unbestimmt“ und werden bei der Zählung der fehlgeschlagenen Aufgabenausführungen nicht berücksichtigt.
Wenn der Parameter auf
0
gesetzt ist, wird die fehlgeschlagene Aufgabe nicht automatisch angehalten.Wenn der Parameter auf einen Wert größer als
0
gesetzt wird, gilt für Ausführungen von eigenständigen Aufgaben bzw. von Stammaufgaben eines Task-Graphen das folgende Verhalten:Eine eigenständige Aufgabe wird automatisch angehalten, wenn die angegebene Anzahl aufeinanderfolgender Aufgabenausführungen entweder fehlschlägt oder eine Zeitüberschreitung verursacht.
Eine Stammaufgabe wird automatisch angehalten, wenn die Ausführung einer beliebigen Einzelaufgabe im Task-Graphen fehlgeschlagen ist oder wenn die angegebene Anzahl von aufeinanderfolgenden Ausführungen überschritten ist.
Der Standardwert für den Parameter ist auf
10
gesetzt, was bedeutet, dass die Aufgabe nach 10 aufeinanderfolgenden fehlgeschlagenen Aufgabenausführungen automatisch angehalten wird.Wenn Sie den Parameterwert explizit auf Konto-, Datenbank- oder Schemaebene festlegen, wird die Änderung bei der nächsten geplanten Ausführung der im geänderten Objekt enthaltenen Aufgaben wirksam (einschließlich aller untergeordneten Aufgaben einer gerade aktiven Task-Graph-Ausführung).
Durch das Anhalten einer eigenständigen Aufgabe wird der Zähler für die fehlgeschlagenen Aufgabenausführungen zurückgesetzt. Wenn Sie die Stammaufgabe eines Task-Graphen anhalten, wird der Zähler für jede Aufgabe im Task-Graphen zurückgesetzt.
- Werte:
0
– Keine Obergrenze.- Standard:
10
TIMESTAMP_DAY_IS_ALWAYS_24H¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob die DATEADD-Funktion (und ihre Aliasnamen) bei Ausdrücken, die sich über mehrere Tage erstrecken, für einen Tag immer genau 24 Stunden berücksichtigt.
- Werte:
TRUE
: Ein Tag hat immer genau 24 Stunden.FALSE
: Ein Tag hat nicht immer 24 Stunden.- Standard:
FALSE
Wichtig
Bei Einstellung auf TRUE
kann die tatsächliche Tageszeit nicht beibehalten werden, wenn die Sommerzeit (DST) gilt. Beispiel:
alter session set TIMESTAMP_DAY_IS_ALWAYS_24H = true;
-- With DST beginning on 2018-03-11 at 2 AM, America/Los_Angeles time zone
select dateadd(day, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ), dateadd(day, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ);
+-------------------------------------------------------+-------------------------------------------------------+
| DATEADD(DAY, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ) | DATEADD(DAY, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ) |
|-------------------------------------------------------+-------------------------------------------------------|
| 2018-03-11 10:00:00.000 -0700 | 2018-11-04 08:00:00.000 -0800 |
+-------------------------------------------------------+-------------------------------------------------------+
alter session set TIMESTAMP_DAY_IS_ALWAYS_24H = false;
select dateadd(day, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ), dateadd(day, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ);
+-------------------------------------------------------+-------------------------------------------------------+
| DATEADD(DAY, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ) | DATEADD(DAY, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ) |
|-------------------------------------------------------+-------------------------------------------------------|
| 2018-03-11 09:00:00.000 -0700 | 2018-11-04 09:00:00.000 -0800 |
+-------------------------------------------------------+-------------------------------------------------------+
TIMESTAMP_INPUT_FORMAT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt das Eingabeformat für den Datentypalias TIMESTAMP an. Weitere Informationen dazu finden Sie unter Eingabe- und Ausgabeformate für Datum und Uhrzeit.
- Werte:
Jedes gültige, unterstützte Zeitstempelformat oder
AUTO
(
AUTO
gibt an, dass Snowflake versucht, das Format der im System gespeicherten Zeitstempel während der Sitzung automatisch zu ermitteln.)- Standard:
AUTO
TIMESTAMP_LTZ_OUTPUT_FORMAT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt das Anzeigeformat für den Datentyp TIMESTAMP_LTZ an. Wird kein Format angegeben, ist der Standardwert TIMESTAMP_OUTPUT_FORMAT. Weitere Informationen dazu finden Sie unter Eingabe- und Ausgabeformate für Datum und Uhrzeit.
- Werte:
Jedes gültige, unterstützte Zeitstempelformat
- Standard:
Keine
TIMESTAMP_NTZ_OUTPUT_FORMAT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt das Anzeigeformat für den Datentyp TIMESTAMP_NTZ an.
- Werte:
Jedes gültige, unterstützte Zeitstempelformat
- Standard:
YYYY-MM-DD HH24:MI:SS.FF3
TIMESTAMP_OUTPUT_FORMAT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt das Anzeigeformat für den Datentypalias TIMESTAMP an. Weitere Informationen dazu finden Sie unter Eingabe- und Ausgabeformate für Datum und Uhrzeit.
- Werte:
Jedes gültige, unterstützte Zeitstempelformat
- Standard:
YYYY-MM-DD HH24:MI:SS.FF3 TZHTZM
TIMESTAMP_TYPE_MAPPING¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt die Variation TIMESTAMP_* an, der der Aliasname des Datentyps TIMESTAMP zugeordnet ist.
- Werte:
TIMESTAMP_LTZ
,TIMESTAMP_NTZ
oderTIMESTAMP_TZ
- Standard:
TIMESTAMP_NTZ
TIMESTAMP_TZ_OUTPUT_FORMAT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt das Anzeigeformat für den Datentyp TIMESTAMP_TZ an. Wird kein Format angegeben, ist der Standardwert TIMESTAMP_OUTPUT_FORMAT. Weitere Informationen dazu finden Sie unter Eingabe- und Ausgabeformate für Datum und Uhrzeit.
- Werte:
Jedes gültige, unterstützte Zeitstempelformat
- Standard:
Keine
TIMEZONE¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (Konstante)
- Beschreibung:
Gibt die Zeitzone für die Sitzung an.
- Werte:
Sie können einen Zeitzonennamen oder einen Verknüpfungsnamen aus Release 2021a der IANA-Zeitzonendatenbank angeben (z. B.
America/Los_Angeles
,Europe/London
,UTC
,Etc/GMT
usw.).- Standard:
America/Los_Angeles
Bemerkung
Bei Zeitzonennamen wird zwischen Groß-/Kleinschreibung unterschieden. Außerdem müssen sie in einfache Anführungszeichen gesetzt werden (z. B.
'UTC'
).Snowflake bietet keine Unterstützung für die meisten Zeitzonen abkürzungen (z. B.
PDT
,EST
usw.), da sich eine bestimmte Abkürzung auf mehrere verschiedenen Zeitzonen beziehen kann. So kann sichCST
beispielsweise auf die „Central Standard Time“ in Nordamerika (UTC-6), die „Cuba Standard Time“ (UTC-5) und die „China Standard Time“ (UTC+8) beziehen.
TIME_INPUT_FORMAT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt das Eingabeformat für den Datentyp TIME an. Weitere Informationen dazu finden Sie unter Eingabe- und Ausgabeformate für Datum und Uhrzeit.
- Werte:
Jedes gültige, unterstützte Zeitformat oder
AUTO
(
AUTO
gibt an, dass Snowflake versucht, das Format der im System gespeicherten Zeiten während der Sitzung automatisch zu ermitteln.)- Standard:
AUTO
TIME_OUTPUT_FORMAT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt das Anzeigeformat für den Datentyp TIME an. Weitere Informationen dazu finden Sie unter Eingabe- und Ausgabeformate für Datum und Uhrzeit.
- Werte:
Jedes gültige, unterstützte Zeitformat
- Standard:
HH24:MI:SS
TRACE_LEVEL¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Typ:
Objekt (für Datenbanken, Schemas, gespeicherte Prozeduren und UDFs) – Kann festgelegt werden für Konto » Datenbank » Schema » Prozedur und Konto » Datenbank » Schema » Funktion
- Datentyp:
Zeichenfolge (Konstante)
- Beschreibung:
Steuert, wie Ablaufverfolgungsereignisse in der Ereignistabelle erfasst werden. Weitere Informationen zu Ablaufverfolgungsebenen finden Sie unter Einstellen des Protokolliergrads (Ablaufverfolgungsebene).
- Werte:
ALWAYS
: Alle Bereiche (Spans) und Ablaufverfolgungsereignisse werden in der Ereignistabelle erfasst.ON_EVENT
: Ablaufverfolgungsereignisse werden nur in der Ereignistabelle erfasst, wenn Ereignisse explizit durch die gespeicherten Prozeduren oder UDFs hinzugefügt werden.OFF
: Es werden keine Bereiche (Spans) und Ablaufverfolgungsereignisse in der Ereignistabelle erfasst.- Standard:
OFF
Bemerkung
Beim Verfolgen von Ereignissen müssen Sie auch den Parameter LOG_LEVEL auf einen der unterstützten Werte setzen.
TRANSACTION_ABORT_ON_ERROR¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
BOOLEAN
- Beschreibung:
Gibt die Aktion an, die ausgeführt werden soll, wenn eine Anweisung, die innerhalb einer Nicht-Autocommit-Transaktion ausgegeben wurde, mit einem Fehler zurückgegeben wird.
- Werte:
TRUE
: Die Nicht-Autocommit-Transaktion wird abgebrochen. Alle innerhalb dieser Transaktion ausgegebenen Anweisungen schlagen fehl, bis eine Commit- oder Rollback-Anweisung ausgeführt wird, um diese Transaktion abzuschließen.FALSE
: Die Nicht-Autocommit-Transaktion wird nicht abgebrochen.- Standard:
FALSE
TRANSACTION_DEFAULT_ISOLATION_LEVEL¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt die Isolationsebene für Transaktionen in der Benutzersitzung an.
- Werte:
READ COMMITTED
(nur aktuell unterstützter Wert)- Standard:
READ COMMITTED
TWO_DIGIT_CENTURY_START¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zahl
- Beschreibung:
Gibt das Jahr des „Jahrhundertanfangs“ für zweistellige Jahre an (d. h. das früheste Jahr, das solche Daten darstellen können). Dieser Parameter verhindert mehrdeutige Datumsangaben beim Importieren oder Konvertieren von Daten mit der Datumsformatkomponente
YY
(d. h. Jahre, die als zweistellige Zahlen dargestellt werden).- Werte:
1900
bis2100
(jeder Wert außerhalb dieses Bereichs gibt einen Fehler zurück)- Standard:
1970
Beispiel:
Jahr |
Parameter auf |
Parameter auf |
Parameter auf |
Parameter auf |
Parameter auf |
|
---|---|---|---|---|---|---|
|
wird zu: |
|
|
|
|
|
|
wird zu: |
|
|
|
|
|
|
wird zu: |
|
|
|
|
|
|
wird zu: |
|
|
|
|
|
UNSUPPORTED_DDL_ACTION¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zeichenfolge (Konstante)
- Beschreibung:
Bestimmt, ob ein für eine Einschränkungseigenschaft nicht unterstützter (d. h. nicht standardmäßiger) Wert einen Fehler zurückgibt.
- Werte:
IGNORE
: Snowflake gibt keinen Fehler für nicht unterstützte Werte zurück.FAIL
: Snowflake gibt einen Fehler für nicht unterstützte Werte zurück.- Standard:
IGNORE
Wichtig
Dieser Parameter bestimmt nicht, ob die Einschränkung erstellt wird. Snowflake erstellt keine Einschränkungen mit nicht unterstützten Werten, unabhängig davon, wie dieser Parameter festgelegt ist.
Weitere Informationen dazu finden Sie unter Einschränkungseigenschaften.
USE_CACHED_RESULT¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Boolesch
- Beschreibung:
Gibt an, ob persistierte Abfrageergebnisse, falls verfügbar, beim Senden einer übereinstimmenden Abfrage wiederverwendet werden sollen.
- Werte:
TRUE
: Wenn eine Abfrage gesendet wird, sucht Snowflake nach übereinstimmenden Abfrageergebnissen für zuvor ausgeführte Abfragen. Wenn ein übereinstimmendes Ergebnis vorliegt, wird das Ergebnis verwendet, anstatt die Abfrage auszuführen. Dies kann dazu beitragen, die Abfragezeit zu verkürzen, da Snowflake das Ergebnis direkt aus dem Cache abruft.FALSE
: Snowflake führt jede Abfrage beim Senden aus, unabhängig davon, ob ein übereinstimmendes Abfrageergebnis vorhanden ist.- Standard:
TRUE
USER_TASK_MANAGED_INITIAL_WAREHOUSE_SIZE¶
- Typ:
Objekt (für Datenbanken, Schemas und Aufgaben) – Kann festgelegt werden für Konto » Datenbank » Schema » Aufgabe
- Datentyp:
Zeichenfolge (String)
- Beschreibung:
Gibt die Größe der Computeressourcen an, die für die erstmalige Ausführung der Aufgabe bereitgestellt werden sollen, bevor ein Aufgabenverlauf für Snowflake verfügbar ist, um eine ideale Größe zu ermitteln. Sobald eine Aufgabe mehrmals erfolgreich ausgeführt wurde, ignoriert Snowflake diese Parametereinstellung. Wenn der Aufgabenverlauf für eine bestimmte Aufgabe nicht verfügbar ist, kehren die Computeressourcen zu dieser ursprünglichen Größe zurück.
Bemerkung
Dieser Parameter gilt nur für serverlose Aufgaben.
Die Größe entspricht den Computeressourcen, die beim Erstellen eines Warehouses verfügbar sind. Wenn der Parameter weggelassen wird, werden die ersten Ausführungen der Aufgabe mit einem mittelgroßen (
MEDIUM
) Warehouse ausgeführt.Sie können die Anfangsgröße von einzelnen Aufgaben ändern (mit ALTER TASK), nachdem die Aufgabe erstellt und bevor sie einmal erfolgreich ausgeführt wurde. Eine Änderung des Parameters nach Start der ersten Ausführung dieser Aufgabe hat keine Auswirkungen auf die Computeressourcen für aktuelle oder zukünftige Aufgabenausführungen.
Beachten Sie, dass das Anhalten und Fortsetzen einer Aufgabe nicht den Aufgabenverlauf entfernt, der zur Größenbestimmung der benötigten Computeressourcen verwendet wurde. Der Aufgabenverlauf wird nur entfernt, wenn die Aufgabe neu erstellt wird (mit der Syntax CREATE OR REPLACETASK).
- Werte:
Jede herkömmliche Warehouse-Größe:
SMALL
,MEDIUM
,LARGE
usw. bis zur maximalen GrößeXXLARGE
.- Standard:
MEDIUM
USER_TASK_TIMEOUT_MS¶
- Typ:
Objekt (für Datenbanken, Schemas und Aufgaben) – Kann festgelegt werden für Konto » Datenbank » Schema » Aufgabe
- Datentyp:
Zahl
- Beschreibung:
Gibt das Zeitlimit für die einzelne Ausführung der Aufgabe an, bevor das Zeitlimit überschritten wird (in Millisekunden).
Bemerkung
Bevor Sie das Zeitlimit für Aufgaben erheblich erhöhen, sollten Sie prüfen, ob die SQL-Anweisungen in den Aufgabendefinitionen optimiert werden können (entweder durch Umschreiben der Anweisungen oder durch Verwendung von gespeicherten Prozeduren) oder ob die Warehouse-Größe für Aufgaben mit benutzerverwalteten Computeressourcen erhöht werden sollte.
In manchen Situationen hat der Parameter STATEMENT_TIMEOUT_IN_SECONDS Vorrang vor USER_TASK_TIMEOUT_MS. Weitere Details dazu finden Sie unter STATEMENT_TIMEOUT_IN_SECONDS.
- Werte:
0
–86400000
(1 Tag)- Standard:
3600000
(1 Stunde)
WEEK_OF_YEAR_POLICY¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zahl
- Beschreibung:
Gibt an, wie die Wochen in einem bestimmten Jahr berechnet werden.
- Werte:
0
: Die verwendete Semantik entspricht der ISO-Semantik, bei der eine Woche zu einem bestimmten Jahr gehört, wenn sich mindestens 4 Tage dieser Woche in diesem Jahr befinden.1
: Der 1. Januar liegt in der ersten Woche des Jahres und der 31. Dezember in der letzten Woche des Jahres.- Standard:
0
(d. h. ISO-ähnliches Verhalten)
Tipp
1
ist der häufigste Wert, basierend auf dem Feedback, das wir erhalten haben. Weitere Informationen, einschließlich Beispiele, finden Sie unter Kalenderwochen und Wochentage.
WEEK_START¶
- Typ:
Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung
- Datentyp:
Zahl
- Beschreibung:
Gibt den ersten Tag der Woche an (wird von wochenbezogenen Datumsfunktionen verwendet).
- Werte:
0
: Früheres Snowflake-Verhalten wird verwendet (d. h. ISO-ähnliches Verhalten)1
(Montag) bis7
(Sonntag): Alle wochenbezogenen Funktionen verwenden Wochen, die am angegebenen Wochentag beginnen.- Standard:
0
(d. h. früheres Snowflake-Verhalten)
Tipp
1
ist der häufigste Wert, basierend auf dem Feedback, das wir erhalten haben. Weitere Informationen, einschließlich Beispiele, finden Sie unter Kalenderwochen und Wochentage.