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:

Hierarchie der Konto-, Sitzungs- und Objektparameter

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

ALLOW_CLIENT_MFA_CACHING

ALLOW_ID_TOKEN

Wird verwendet, um das Verbindungscaching in browserbasiertem Single Sign-On (SSO) für von Snowflake bereitgestellte Clients zu aktivieren

CLIENT_ENCRYPTION_KEY_SIZE

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

ENABLE_TRI_SECRET_AND_REKEY_OPT_OUT_FOR_IMAGE_REPOSITORY

Dient zur Angabe der Entscheidung eines Image-Repository, Tri-Secret Secure und Periodische Wiederverschlüsselung nicht zu verwenden.

ENABLE_IDENTIFIER_FIRST_LOGIN

ENABLE_INTERNAL_STAGES_PRIVATELINK

Erlaubt der Funktion SYSTEM$GET_PRIVATELINK_CONFIG, den Schlüssel private-internal-stages im Abfrageergebnis zurückzugeben.

EVENT_TABLE

Wird verwendet, um eine Ereignistabelle als aktive Ereignistabelle des Kontos festzulegen.

ENFORCE_NETWORK_RULES_FOR_INTERNAL_STAGES

EXTERNAL_OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST

INITIAL_REPLICATION_SIZE_LIMIT_IN_TB

MIN_DATA_RETENTION_TIME_IN_DAYS

Ermöglicht die Festlegung der minimalen Datenaufbewahrungsfrist für historische Daten von Time Travel-Operationen.

NETWORK_POLICY

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.

OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST

PERIODIC_DATA_REKEYING

PREVENT_UNLOAD_TO_INLINE_URL

REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_CREATION

REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_OPERATION

SSO_LOGIN_PAGE

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

CATALOG

Datenbank, Schema

DATA_RETENTION_TIME_IN_DAYS

Datenbank, Schema, Tabelle

DEFAULT_DDL_COLLATION

Datenbank, Schema, Tabelle

ENABLE_ETL_REPLICATION

Replikationsgruppe, Failover-Gruppe

Veraltet. Weitere Informationen dazu finden Sie unter ENABLE_ETL_REPLICATION.

ENABLE_UNREDACTED_QUERY_SYNTAX_ERROR

Benutzer

Beeinflusst den Abfrageverlauf für Abfragen, die aufgrund von Syntax- oder Parsing-Fehlern fehlschlagen.

EXTERNAL_VOLUME

Datenbank, Schema

LOG_LEVEL

Datenbank, Schema, gespeicherte Prozedur, Funktion

MAX_CONCURRENCY_LEVEL

Warehouse

MAX_DATA_EXTENSION_TIME_IN_DAYS

Datenbank, Schema, Tabelle

PIPE_EXECUTION_PAUSED

Schema, Pipe

PREVENT_UNLOAD_TO_INTERNAL_STAGES

Benutzer

STATEMENT_QUEUED_TIMEOUT_IN_SECONDS

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.

STATEMENT_TIMEOUT_IN_SECONDS

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.

NETWORK_POLICY

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.

SUSPEND_TASK_AFTER_NUM_FAILURES

Datenbank, Schema, Aufgabe

TRACE_LEVEL

Datenbank, Schema, gespeicherte Prozedur, Funktion

USER_TASK_MANAGED_INITIAL_WAREHOUSE_SIZE

Datenbank, Schema, Aufgabe

USER_TASK_TIMEOUT_MS

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;
Copy

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;
Copy

Anzeigen aller Parameter

Um alle -Parameter anzuzeigen, einschließlich Konto- und Objektparameter, fügen Sie eine IN ACCOUNT-Klausel ein:

SHOW PARAMETERS IN ACCOUNT;
Copy

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%';
    
    Copy
  • So zeigen Sie die Sitzungsparameter an, deren Namen mit „time“ beginnen:

    SHOW PARAMETERS LIKE 'time%' IN ACCOUNT;
    
    Copy

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

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

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

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:

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

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

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

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:

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

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

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

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

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

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

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

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 FALSE gesetzt (Standardeinstellung)

Parameter auf TRUE gesetzt

"columnname"

wird aufgelöst in:

columnname

COLUMNNAME

"columnName"

wird aufgelöst in:

columnName

COLUMNNAME

"ColumnName"

wird aufgelöst in:

ColumnName

COLUMNNAME

"COLUMNNAME"

wird aufgelöst in:

COLUMNNAME

COLUMNNAME

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

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

Nicht standardmäßige JSON-Eingabe

Parameter auf FALSE gesetzt (Standardeinstellung)

Parameter auf TRUE gesetzt

[289, 2188,]

Ausgaben:

[ 289, 2188, undefined ]

[ 289, 2188, null ]

[undefined, undefined]

Ausgaben:

[ undefined, undefined ]

[ null, null ]

[Infinity,inf,-Infinity,-inf]

Ausgaben:

[ Infinity, Infinity, -Infinity, -Infinity ]

[ "Infinity", "Infinity", "-Infinity", "-Infinity" ]

[NaN,nan]

Ausgaben:

[ NaN, NaN ]

[ "NaN", "NaN" ]

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

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

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

Standard:

1970

Beispiel:

Jahr

Parameter auf 1900 gesetzt

Parameter auf 1970 gesetzt (Standardeinstellung)

Parameter auf 1980 gesetzt

Parameter auf 1990 gesetzt

Parameter auf 2000 gesetzt

00

wird zu:

1900

2000

2000

2000

2000

79

wird zu:

1979

1979

2079

2079

2079

89

wird zu:

1989

1989

1989

2089

2089

99

wird zu:

1999

1999

1999

1999

2099

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öß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)

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) bis 7 (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.