Parameter¶

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:

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.

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

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:

• JDBC-Treiber

• ODBC-Treiber

• Snowflake-Konnektor für Python

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 oder UTF8 / 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 oder BASE64

Standard

HEX

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 Namen TRACING auf INFO oder ALL.

• Setzen Sie TRACING auf ALL, um alle Debugging-Informationen und alle Bindungsinformationen anzuzeigen.

• Setzen Sie TRACING auf INFO, 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 oder FALSE.

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 oder 256

Standard

128

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.

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 Schemaargumente null sind, durchsucht die Methode standardmäßig alle Datenbanken und alle Schemas im Konto. Wenn Sie CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX auf TRUE 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:

1. Werte, die als Argumente an die Funktionen/Methoden übergeben wurden.

2. Im Verbindungskontext angegebene Werte (falls vorhanden).

3. 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 Schemaargumente null 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 Schemaargumente null 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:

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

2. Geben Sie die Datenbank und das Schema an, wenn Sie über den Treiber eine Verbindung zu Snowflake herstellen.

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

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

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 bis 10

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 bis 160

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

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 bis 3600

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 oder TIMESTAMP_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 oder 1 (für Standard Edition)

0 bis 90 (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:

• CREATE TABLE

• 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');

Copy

Werte

Jede gültige, unterstützte Sortierungsspezifikation.

Standard

Leere Zeichenfolge

ENABLE_ETL_REPLICATION¶

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üssel private-internal-stages und den Wert im Abfrageergebnis zurück.

FALSE: Gibt den Schlüssel private-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 Protokollmeldungen oder Ablaufverfolgungsereignisse für unbehandelte Ausnahmen in 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 dies, wie unter Erfassen unbehandelter Ausnahmeeinträge aktivieren beschrieben, weiter aktiviert ist.

FALSE: Daten zu unbehandelten Ausnahmen werden möglicherweise nicht erfasst.

Standard

FALSE

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 entsprechenden MODE und TYPE 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 Eigenschaft EXTERNAL_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 Eigenschaft EXTERNAL_OAUTH_BLOCKED_ROLES_LIST der External OAuth-Sicherheitsintegration definiert sind.

Standard

TRUE

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 oder EWKB

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 oder EWKB

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() und getTimestamp() der ResultSet-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 bis 16

(Der Wert 0 gibt eine kompakte Ausgabe zurück, indem alle Leerzeichen und Zeilenumbrüche aus der Ausgabe entfernt werden.)

Standard

2

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

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 von 0 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

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 bis 90 (d. h. 90 Tage). Ein Wert von 0 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

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 oder 1 (für Standard Edition)

0 bis 90 (für Enterprise Edition oder höher)

Standard

0

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

Werte

Eine vorhandene Netzwerkrichtlinie (erstellt mit CREATE NETWORK POLICY)

Standard

Keine

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 Eigenschaft BLOCKED_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 Eigenschaft BLOCKED_ROLES_LIST der Snowflake OAuth-Sicherheitsintegration definiert sind.

Standard

TRUE

SHARE_RESTRICTIONS¶

Typ

Objekt (für Freigaben) – Kann für Freigabe festgelegt werden.

Datentyp

Boolesch

Beschreibung

Dieser Parameter gilt nur für das Data Sharing. Er aktiviert/deaktiviert das Hinzufügen eines Nicht-Business Critical-Verbraucherkontos zu einer Freigabe, die zu einem Business Critical-Anbieterkonto gehört. Weitere Informationen dazu finden Sie unter Aktivieren von Freigaben eines Business Critical-Kontos für ein Nicht-Business Critical-Konto.

Werte

FALSE: Ein Nicht-Business Critical-Verbraucherkonto kann zu einer Freigabe hinzugefügt werden, die zu einem Business Critical-Anbieterkonto gehört.

TRUE: Ein Nicht-Business Critical-Verbraucherkonto kann nicht zu einer Freigabe hinzugefügt werden, die zu einem Business Critical-Anbieterkonto gehört.

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

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 den executionState als PAUSED 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 den executionState als RUNNING 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)

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:

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 Wert 0 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 mit vpce.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 und vpce-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" : ""
}

Copy

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 Feld label 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.

Copy

Weitere Informationen dazu finden Sie unter Einführung in Secure Data Sharing und Verwenden von Freigaben.

Standard

Keine

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:

• Migration zu einer SAML2-Sicherheitsintegration

• Kontobezeichner

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 Wert 0 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 bis 604800 (d. h. 7 Tage) – der Wert 0 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:

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 DAG 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 DAG-Stammaufgaben 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 DAG 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.

Die Einstellung gilt für Aufgaben, die entweder auf von Snowflake verwaltete Computeressourcen (d. h. ein serverloses Computemodell) oder auf vom Benutzer verwaltete Computeressourcen (d. h. ein virtuelles Warehouse) angewiesen sind.

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 DAG-Ausführung).

Durch das Anhalten einer eigenständigen Aufgabe wird der Zähler für die fehlgeschlagenen Aufgabenausführungen zurückgesetzt. Durch das Anhalten der Stammaufgabe eines DAG wird der Zähler für jede Aufgabe im DAG 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

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 oder TIMESTAMP_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

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

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 bis 2100 (jeder Wert außerhalb dieses Bereichs gibt einen Fehler zurück)

Standard

1970

Beispiel:

UNSUPPORTED_DDL_ACTION¶

Typ

Sitzung – Kann festgelegt werden für Konto » Benutzer » Sitzung

Datentyp

Zeichenfolge (Konstante)

Beschreibung

Gibt an, 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

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öße XXLARGE.

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)

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) bis 7 (Sonntag): Alle wochenbezogenen Funktionen verwenden Wochen, die am angegebenen Wochentag beginnen.

Standard

0 (d. h. früheres Snowflake-Verhalten)