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:

Hierarchy of account, session, and object parameters

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_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 bereitgestellten Dateien verwendet; erfordert möglicherweise zusätzliche Installations- und Konfigurationsaktivitäten (Details siehe Beschreibung).

INITIAL_REPLICATION_SIZE_LIMIT_IN_TB

NETWORK_POLICY

Dies ist der einzige Kontoparameter, der von Kontoadministratoren (ACCOUNTADMIN) oder Sicherheitsadministratoren (SECURITYADMIN) festgelegt werden kann.

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

DATA_RETENTION_TIME_IN_DAYS

Datenbank, Schema, Tabelle

DEFAULT_DDL_COLLATION

Datenbank, Schema, Tabelle

MAX_CONCURRENCY_LEVEL

Warehouse

MAX_DATA_EXTENSION_TIME_IN_DAYS

Datenbank, Schema, Tabelle

PIPE_EXECUTION_PAUSED

Schema, Pipe

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 Kontoparameter, der von Kontoadministratoren (ACCOUNTADMIN) oder Sicherheitsadministratoren (SECURITYADMIN) festgelegt werden kann.

SHARE_RESTRICTIONS

Freigabe

Dieser Parameter kann entweder von Kontoadministratoren (ACCOUNTADMIN) oder einer Rolle mit der Berechtigung OVERRIDE SHARE RESTRICTIONS festgelegt werden.

Bemerkung

Standardmäßig werden Objektparameter nicht in der Ausgabe von SHOW PARAMETERS angezeigt. Weitere Informationen zum Anzeigen von Objektparametern finden Sie unter Anzeigen von Parametern und deren Werten (unter diesem Thema).

Anzeigen von Parametern und deren Werten

Snowflake bietet den Befehl SHOW PARAMETERS, der eine Liste der Parameter zusammen mit den aktuellen Werten und den Standardwerten für jeden Parameter anzeigt. Der Befehl kann mit verschiedenen Optionen aufgerufen werden, um den angezeigten Parametertyp zu bestimmen.

Sitzungs- und Objektparameter anzeigen

Standardmäßig zeigt der Befehl nur Sitzungsparameter an:

SHOW PARAMETERS;

Um die Objektparameter für ein bestimmtes Objekt anzuzeigen, fügen Sie dem Objekttyp und dem Namen eine IN-Klausel hinzu. Beispiel:

SHOW PARAMETERS IN DATABASE mydb;

SHOW PARAMETERS IN WAREHOUSE mywh;

Anzeigen aller Parameter

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

SHOW PARAMETERS IN ACCOUNT;

Einschränken der Liste der Parameter nach Namen

Der Befehl unterstützt auch die Verwendung einer LIKE-Klausel, um die Liste der Parameter nach Namen einzuschränken. Beispiel:

  • So zeigen Sie die Sitzungsparameter an, deren Namen „time“ enthalten:

    SHOW PARAMETERS LIKE '%time%';
    
  • So zeigen Sie die Sitzungsparameter an, deren Namen mit „time“ beginnen:

    SHOW PARAMETERS LIKE 'time%' IN ACCOUNT;
    

Bemerkung

Die LIKE-Klausel muss vor der IN-Klausel stehen.

ABORT_DETACHED_QUERY

Typ

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

Datentyp

Boolesch

Beschreibung

Gibt die Aktion an, die Snowflake für laufende Abfragen ausführt, wenn die Verbindung aufgrund einer abrupten Beendigung einer Sitzung (z. B. Netzwerkausfall, Browserbeendigung, Dienstunterbrechung) unterbrochen wird.

Werte

TRUE: In Ausführung befindliche Abfragen werden 5 Minuten nach Verbindungsverlust abgebrochen.

FALSE: In Bearbeitung befindliche Abfragen werden abgeschlossen.

Standard

FALSE

Bemerkung

  • Wenn der Benutzer die Verbindung explizit beendet, werden alle ausgeführten Abfragen unabhängig vom Parameterwert sofort abgebrochen.

  • 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 der 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_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 (Optional) Verwenden von Verbindungs-Caching zum Minimieren der Anzahl der Eingabeaufforderungen für die Authentifizierung.

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

Eingabeformat für Binärwerte.

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

Anzeigeformat für Binärwerte.

Werte

HEX oder BASE64

Standard

HEX

CLIENT_ENABLE_LOG_INFO_STATEMENT_PARAMETERS

Typ

Sitzung – Kann nur für Sitzung festgelegt werden

Datentyp

Boolesch

Clients

JDBC

Beschreibung

Ermöglicht Benutzern das Protokollieren der an PreparedStatements gebundenen Datenwerte.

Um die Werte anzuzeigen, müssen Sie nicht nur diesen Parameter auf Sitzungsebene auf TRUE setzen, sondern auch den Verbindungsparameter mit dem Namen TRACING auf INFO oder ALL.

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

  • Setzen Sie TRACING auf INFO, um die Bindungsparameterwerte und wenige andere Debugging-Informationen anzuzeigen.

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 die AES-Verschlüsselungsgröß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 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

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

Beschreibung

Parameter, der die Anzahl der Threads angibt, die vom Client vorab zum Abrufen großer Resultsets verwendet werden. Der Treiber versucht, den Parameterwert einzuhalten, definiert jedoch Mindest- und Höchstwerte (abhängig von den Ressourcen Ihres Systems), um die Leistung zu verbessern.

Werte

1 bis 10

Standard

4

Die meisten Benutzer sollten diesen Parameter nicht einstellen müssen. Wenn dieser Parameter nicht vom Benutzer festgelegt wird, beginnt der Treiber mit der oben angegebenen Standardeinstellung, verwaltet jedoch aktiv die Thread-Anzahl konservativ, um zu vermeiden, dass der gesamte verfügbare Speicher belegt wird.

CLIENT_RESULT_CHUNK_SIZE

Typ

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

Datentyp

Ganzzahl (Integer)

Clients

JDBC

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 kann der Parameter nicht auf Sitzungsebene durch Ausführen des Befehls ALTER SESSION festgelegt werden. 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/Ausgabe von 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 finden Sie unter Eingabe/Ausgabe von 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');
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_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

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

GEOGRAPHY_OUTPUT_FORMAT

Typ

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

Datentyp

Zeichenfolge (Konstante)

Beschreibung

Anzeigeformat für Geodatenwerte.

Für EWKT und EWKB ist die SRID in der Ausgabe immer „4326“. Siehe den Hinweis zur Verwendung von EWKT und EWKB.

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 Skala von mindestens 1 (z. B. 20.5, 32.25, 33.333 usw.).

Standard

10.0

JDBC_TREAT_DECIMAL_AS_INT

Typ

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

Datentyp

Boolesch

Beschreibung

Gibt an, wie JDBC Spalten mit einer Skalierung von null (0) verarbeitet.

Werte

TRUE: JDBC verarbeitet eine Spalte, deren Skalierung null ist, als BIGINT.

FALSE: JDBC verarbeitet eine Spalte, deren Skalierung 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 vom Typ TIMESTAMP_NTZ von Snowflake abruft, konvertiert der Treiber den Wert standardmäßig auf Basis der Sitzung des Benutzers von UTC in die aktuelle Zeitzone.

Benutzer, die TIMESTAMP_NTZ-Werte in UTC behalten möchten, können diesen Parameter auf TRUE setzen.

Dieser Parameter gilt nur für den JDBC-Treiber.

Werte

TRUE: Der Treiber ändert den Wert TIMESTAMP_NTZ nicht. Der Wert bleibt in UTC.

FALSE: Der Treiber konvertiert den Wert TIMESTAMP_NTZ von UTC in den Wert der

aktuelle Zeitzone des Benutzers.

Standard

FALSE

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 Skalierung von null (0) verarbeitet, z. B. INTEGER oder NUMBER(p, 0).

Werte

TRUE: JavaScript verarbeitet eine Spalte, deren Skalierung null ist, als BIGINT.

FALSE: JavaScript verarbeitet eine Spalte, deren Skalierung null ist, als Zahl (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 in 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 Ganzahl-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 bis zu einer beliebigen Zahl (d. h. keine Begrenzung)

(Der Wert 0 deaktiviert die Sperrwartezeit, d. h. die Anweisung muss die Sperre sofort anfordern oder abbrechen. Wenn von der Anweisung mehrere Ressourcen gesperrt werden müssen, gilt das Timeout für jeden Sperrversuch separat.)

Standard

43200 (d. h. 12 Stunden)

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-Cluster ausgeführt werden. Wenn der Grad erreicht ist, hängt die durchgeführte Operation davon ab, ob es sich bei dem Warehouse um einen oder mehrere Cluster 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.

Beachten Sie, dass dieser Parameter die Anzahl der Anweisungen, die von einem Warehouse-Cluster gleichzeitig ausgeführt werden können, nicht begrenzt. Stattdessen dient er als obere Grenze zum Schutz vor einer übermäßigen Zuteilung von Ressourcen. Da jede Anweisung an ein Warehouse übermittelt wird, weist Snowflake Ressourcen für die Ausführung der Anweisung zu. Wenn nicht genügend Ressourcen zur Verfügung stehen, werden je nach Warehouse Anweisungen in die Warteschlange gestellt oder zusätzliche Cluster gestartet.

Die tatsächliche Anzahl der Anweisungen, die gleichzeitig von einem Warehouse-Cluster ausgeführt werden, kann ü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 Server eines Warehouse-Clusters 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 Verringern des Parallelitätsgrads für ein Warehouse wird die Zuweisung von Computeressourcen pro Anweisung erhöht, um die Abfrageleistung potenziell zu beschleunigen, insbesondere bei großen/komplexen Abfragen mit mehreren Anweisungen.

  • Durch Erhöhen des Parallelitätsgrads für ein Warehouse wird die Zuteilung von Computeressourcen pro Anweisung verringert. Dadurch wird die Anzahl der gleichzeitigen Abfragen, die vom Warehouse ausgeführt werden können, jedoch nicht notwendigerweise begrenzt. Auch wird die gesamte Warehouse-Leistung, die von der Art der ausgeführten Abfragen abhängt, nicht notwendigerweise verbessert.

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

JDBC, 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.

Negative Zahlen sind nicht erlaubt.

Standard

1

NETWORK_POLICY

Typ

Konto – Kann nur für Konto festgelegt werden (von Kontoadministratoren und auch von Systemadministratoren)

Typ

Objekt (für Benutzer) – Kann für Konto » Benutzer festgelegt werden

Datentyp

Zeichenfolge (String)

Beschreibung

Gibt die Netzwerkrichtlinie an, die für Ihr Konto durchgesetzt werden soll. Netzwerkrichtlinien ermöglichen die Beschränkung des Zugriffs auf Ihr Konto basierend auf der IP-Adresse der Benutzer. Weitere Details dazu finden Sie unter Netzwerkrichtlinien.

Werte

Eine vorhandene Netzwerkrichtlinie (erstellt mit CREATE NETWORK POLICY)

Standard

Keine

Bemerkung

Dies ist der einzige Kontoparameter, der von Sicherheitsadministratoren (SECURITYADMIN) oder höher festgelegt werden kann.

SHARE_RESTRICTIONS

Typ

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

Datentyp

Boolesch

Beschreibung

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

Werte

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

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

Standard

TRUE

Bemerkung

Dieser Parameter kann nicht auf Kontoebene festgelegt werden.

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 Datenverschlüsselung.

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 Verstehen 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 zu erzwingen.

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

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

Tabelle – Kann für die Tabelle » Schema » Datenbank festgelegt werden

Datentyp

Boolesch

Beschreibung

Gibt an, ob die Groß-/Kleinschreibung bei allen Objektbezeichnern in doppelten Anführungszeichen ignoriert wird.

Werte

TRUE: Bei Bezeichnern in doppelten Anführungszeichen wird die Groß-/Kleinschreibung nicht berücksichtigt (d. h. Groß-/Kleinschreibung wird ignoriert und alle Buchstaben werden als Großbuchstaben behandelt).

FALSE: Bei doppelten Anführungszeichen wird zwischen Groß-/Kleinschreibung unterschieden. 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

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

SAML_IDENTITY_PROVIDER

Typ

Konto – Kann nur für Konto festgelegt werden

Datentyp

JSON

Beschreibung

Aktiviert die Verbundauthentifizierung. Der Parameter akzeptiert ein in einfache Anführungszeichen eingeschlossenes JSON-Objekt mit den folgenden Feldern:

{
  "certificate": "",
  "issuer": "",
  "ssoUrl": "",
  "type"  : "",
  "label" : ""
}

Wobei:

certificate

Gibt das Zertifikat an (generiert vom IdP), das die Kommunikation zwischen dem IdP und Snowflake überprüft.

issuer

Zeigt den Aussteller bzw. die EntityID des IdP an.

Optional.

Informationen darüber, wie Sie diesen Wert in Okta und ADFS erhalten, finden Sie unter Konfigurieren von Snowflake für die Verwendung der Verbundauthentifizierung.

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 Konfigurieren von Snowflake für die Verwendung der Verbundauthentifizierung.

Standard

Keine

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

Derzeit unterstützt der Sitzungsparameter SIMULATED_DATA_SHARING_CONSUMER nur sichere Ansichten und sichere materialisierte Ansichten, nicht jedoch sichere UDFs.

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

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://<Kontoname>.snowflakecomputing.com/console/login?fedpreview=true

  • Wenn sich Ihr Konto in einer anderen Region befindet: https://<Kontoname>.<Regions-ID>.snowflakecomputing.com/console/login?fedpreview=true

Weitere Informationen dazu finden Sie unter Konfigurieren von Snowflake für die Verwendung der Verbundauthentifizierung.

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 erzwungen. 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 Sitzungs-Timeout hat Vorrang (d. h. alle in der Sitzung übermittelten Anweisungen werden nach 60 Sekunden in der Warteschlange abgebrochen).

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 Wert, der nicht Null ist, erzwungen. Beispiel:

  • Ein Warehouse hat ein Timeout von 1.000 Sekunden.

  • Das Timeout für die Sitzung ist auf 500 Sekunden festgelegt.

Das Sitzungs-Timeout hat Vorrang (d. h. jede in der Sitzung übermittelte Anweisung wird abgebrochen, nachdem sie länger als 500 Sekunden ausgeführt wurde).

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 erzwingt folgendes Verhalten:

  • 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" ]

TIMESTAMP_DAY_IS_ALWAYS_24H

Typ

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

Datentyp

Boolesch

Beschreibung

Gibt an, ob die DATEADD-Funktion (und ihre Aliasnamen) bei Ausdrücken, die sich über mehrere Tage erstrecken, für einen Tag immer genau 24 Stunden berücksichtigt.

Werte

TRUE: Ein Tag hat immer genau 24 Stunden.

FALSE: Ein Tag hat nicht immer 24 Stunden.

Standard

FALSE

Wichtig

Bei Einstellung auf TRUE kann die tatsächliche Tageszeit nicht beibehalten werden, wenn die Sommerzeit (DST) gilt. Beispiel:

alter session set TIMESTAMP_DAY_IS_ALWAYS_24H = true;

-- With DST beginning on 2018-03-11 at 2 AM, America/Los_Angeles time zone
select dateadd(day, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ), dateadd(day, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ);

+-------------------------------------------------------+-------------------------------------------------------+
| DATEADD(DAY, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ) | DATEADD(DAY, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ) |
|-------------------------------------------------------+-------------------------------------------------------|
| 2018-03-11 10:00:00.000 -0700                         | 2018-11-04 08:00:00.000 -0800                         |
+-------------------------------------------------------+-------------------------------------------------------+

alter session set TIMESTAMP_DAY_IS_ALWAYS_24H = false;

select dateadd(day, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ), dateadd(day, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ);

+-------------------------------------------------------+-------------------------------------------------------+
| DATEADD(DAY, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ) | DATEADD(DAY, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ) |
|-------------------------------------------------------+-------------------------------------------------------|
| 2018-03-11 09:00:00.000 -0700                         | 2018-11-04 09:00:00.000 -0800                         |
+-------------------------------------------------------+-------------------------------------------------------+

TIMESTAMP_INPUT_FORMAT

Typ

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

Datentyp

Zeichenfolge (String)

Beschreibung

Gibt das Eingabeformat für den Datentypalias TIMESTAMP an. Weitere Informationen dazu finden Sie unter Eingabe/Ausgabe von 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/Ausgabe von 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/Ausgabe von 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/Ausgabe von 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. Eine Liste der Zeitzonen finden Sie unter List of tz database time zones (Liste der Zeitzonen aus der IANA-Zeitzonen-Datenbank) (Wikipedia).

Werte

Standard-IANA.org-Zeitzonen:

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

Bestimmte einfache Zeitzonen wie PDT werden derzeit nicht unterstützt.

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/Ausgabe von 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 finden Sie unter Eingabe/Ausgabe von Datum und Uhrzeit.

Werte

Jedes gültige, unterstützte Zeitformat

Standard

HH24:MI:SS

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

Gibt an, ob ein für eine Einschränkungseigenschaft nicht unterstützter (d. h. nicht standardmäßiger) Wert einen Fehler zurückgibt.

Werte

IGNORE: Snowflake gibt keinen Fehler für nicht unterstützte Werte zurück.

FAIL: Snowflake gibt einen Fehler für nicht unterstützte Werte zurück.

Standard

IGNORE

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 finden Sie unter Einschränkungseigenschaften.

USE_CACHED_RESULT

Typ

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

Datentyp

Boolesch

Beschreibung

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

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.