snow object create¶

Syntax¶

snow object create
  <object_type>
  <object_attributes>
  --json <object_json>
  --if-not-exists
  --replace
  --connection <connection>
  --host <host>
  --port <port>
  --account <account>
  --user <user>
  --password <password>
  --authenticator <authenticator>
  --workload-identity-provider <workload_identity_provider>
  --private-key-file <private_key_file>
  --token <token>
  --token-file-path <token_file_path>
  --database <database>
  --schema <schema>
  --role <role>
  --warehouse <warehouse>
  --temporary-connection
  --mfa-passcode <mfa_passcode>
  --enable-diag
  --diag-log-path <diag_log_path>
  --diag-allowlist-path <diag_allowlist_path>
  --oauth-client-id <oauth_client_id>
  --oauth-client-secret <oauth_client_secret>
  --oauth-authorization-url <oauth_authorization_url>
  --oauth-token-request-url <oauth_token_request_url>
  --oauth-redirect-uri <oauth_redirect_uri>
  --oauth-scope <oauth_scope>
  --oauth-disable-pkce
  --oauth-enable-refresh-tokens
  --oauth-enable-single-use-refresh-tokens
  --client-store-temporary-credential
  --format <format>
  --verbose
  --debug
  --silent
  --enhanced-exit-codes

Argumente¶

object_type

Typ des Objekts, Zum Beispiel Tabelle, Datenbank, Computepool.

object_attributes...

Objektattribute, die als Liste von Schlüssel=Wert-Paaren bereitgestellt werden, z. B. name=my_db comment=‘created with Snowflake CLI‘. In der Dokumentation finden Sie eine vollständige Auflistung der verfügbaren Parameter für jedes Objekt.

Optionen¶

--json TEXT

Objektdefinition im Format JSON, zum Beispiel ‚{„name“: „my_db“, „comment“: „created with Snowflake CLI“}‘. In der Dokumentation finden Sie eine vollständige Auflistung der verfügbaren Parameter für jedes Objekt.

--if-not-exists

Diese Operation nur anwenden, wenn das angegebene Objekt noch nicht existiert. Standard: false

--replace

Dieses Objekt ersetzen, wenn es bereits existiert. Standard: false

--connection, -c, --environment TEXT

Name der Verbindung, wie in Ihrer config.toml-Datei definiert. Standard: Standard.

--host TEXT

Host-Adresse für die Verbindung. Überschreibt den für die Verbindung angegebenen Wert.

--port INTEGER

Port für die Verbindung. Überschreibt den für die Verbindung angegebenen Wert.

--account, --accountname TEXT

Name, der Ihrem Snowflake-Konto zugewiesen wurde. Überschreibt den für die Verbindung angegebenen Wert.

--user, --username TEXT

Benutzername für die Verbindung zu Snowflake. Überschreibt den für die Verbindung angegebenen Wert.

--password TEXT

Snowflake-Kennwort. Überschreibt den für die Verbindung angegebenen Wert.

--authenticator TEXT

Snowflake-Authentifikator. Überschreibt den für die Verbindung angegebenen Wert.

--workload-identity-provider TEXT

Workload-Identitätsanbieter (AWS, AZURE, GCP, OIDC). Überschreibt den für die Verbindung angegebenen Wert.

--private-key-file, --private-key-path TEXT

Dateipfad zum privaten Snowflake-Schlüssel. Überschreibt den für die Verbindung angegebenen Wert.

--token TEXT

OAuth-Token, das bei der Verbindung mit Snowflake verwendet werden soll.

--token-file-path TEXT

Pfad zur Datei mit einem OAuth-Token, das bei der Verbindung mit Snowflake verwendet werden soll.

--database, --dbname TEXT

Zu verwendende Datenbank. Überschreibt den für die Verbindung angegebenen Wert.

--schema, --schemaname TEXT

Zu verwendendes Datenbankschema. Überschreibt den für die Verbindung angegebenen Wert.

--role, --rolename TEXT

Zu verwendende Rolle. Überschreibt den für die Verbindung angegebenen Wert.

--warehouse TEXT

Zu verwendendes Warehouse. Überschreibt den für die Verbindung angegebenen Wert.

--temporary-connection, -x

Verwendet eine mit Befehlszeilenparametern definierte Verbindung anstelle einer in config definierten. Standard: false

--mfa-passcode TEXT

Für die mehrstufige Authentifizierung (MFA) zu verwendendes Token.

--enable-diag

Ob ein Verbindungsdiagnosebericht erstellt werden soll. Standard: false

--diag-log-path TEXT

Pfad für den generierten Bericht. Standardmäßig wird das temporäre Verzeichnis des Systems verwendet. Standard: <system_temporary_directory>.

--diag-allowlist-path TEXT

Pfad zu einer JSON-Datei, die allowlist-Parameter enthält.

--oauth-client-id TEXT

Wert der Client-ID, die vom Identitätsanbieter für die Snowflake-Integration bereitgestellt wird.

--oauth-client-secret TEXT

Wert des Client-Geheimnisses, das vom Identitätsanbieter für die Snowflake-Integration bereitgestellt wird.

--oauth-authorization-url TEXT

Endpunkt des Identitätsanbieters, der den Autorisierungscode an den Treiber liefert.

--oauth-token-request-url TEXT

Endpunkt des Identitätsanbieters, der die Zugriffstoken für den Treiber bereitstellt.

--oauth-redirect-uri TEXT

Für die Umleitung des Autorisierungscodes zu verwendende URI.

--oauth-scope TEXT

Bereich, der in der Autorisierungsanfrage des Identitätsanbieters angefordert wird.

--oauth-disable-pkce

Deaktiviert den Proof Key For Code Exchange (PKCE). Standard: False.

--oauth-enable-refresh-tokens

Ermöglicht eine stille Neuauthentifizierung, wenn das aktuelle Zugriffstoken veraltet ist. Standard: False.

--oauth-enable-single-use-refresh-tokens

Ob Sie sich für die Semantik des einmaligen Aktualisierungs-Tokens entscheiden. Standard: False.

--client-store-temporary-credential

Speichern der temporären Anmeldeinformationen.

--format [TABLE|JSON|JSON_EXT|CSV]

Gibt das Ausgabeformat an. Standard: TABLE.

--verbose, -v

Zeigt Protokolleinträge für die Protokolliergrade info und höher an. Standard: false

--debug

Zeigt Protokolleinträge für die Protokollebenen debug und höher an; Debug-Protokolle enthalten zusätzliche Informationen. Standard: false

--silent

Schaltet Zwischenausgaben auf der Konsole aus. Standard: false

--enhanced-exit-codes

Exit-Fehlercodes nach Art des Fehlers unterscheiden. Standard: false

--help

Zeigt den Hilfetext für diesen Befehl an.

Nutzungshinweise¶

Der Befehl snow object create erstellt einen der folgenden Typen von Snowflake-Objekten, basierend auf den angegebenen Objektattributen oder Definitionen:

• account

• catalog-integration

• compute-pool

• database

• database-role

• dynamic-table

• event-table

• external-volume

• function

• image-repository

• managed-account

• network-policy

• notebook

• notification-integration

• pipe

• procedure

• role

• schema

• service

• stage

• stream

• table

• task

• user-defined-function

• view

• warehouse

Für jedes Objekt müssen Sie die entsprechenden Objektdetails entweder über die Objektattribute oder die Objektdefinitionen angeben.

• Verwenden Sie den object_attributes-Parameter, der die Objektdetails als eine Reihe von <key>=<value>-Paaren angibt, wie z. B:

  snow object create database name=my_db comment="Created with Snowflake CLI"
  

  Copy

• Verwenden Sie die Option --json object_definition, um die Objektdetails als JSON anzugeben, z. B:

  snow object create table name=my_table columns='[{"name":"col1","datatype":"number", "nullable":false}]' constraints='[{"name":"prim_key", "column_names":["col1"], "constraint_type":"PRIMARY KEY"}]' --database my_db --schema public
  

  Copy

• Siehe Beispiele für weitere Beispiele.

In den folgenden Abschnitten werden die Attribute beschrieben, die Snowflake CLI für ausgewählte Objekttypen unterstützt.

• computepool

• Datenbank

• image-repository

• schema

• Service

• Tabelle

• Aufgabe

• warehouse

Sie können Attribute für andere Arten von Objekten finden, indem Sie die entsprechenden SQL CREATE-Befehlverweise überprüfen, z. B. CREATE ACCOUNT.

Beispiele¶

• Erstellen Sie ein Datenbankobjekt mit dem Parameter option-attributes:

  snow object create database name=my_db comment='Created with Snowflake CLI'
  

  Copy

• Erstellen Sie ein Tabellenobjekt unter Verwendung des Parameters option-attributes:

  snow object create table name=my_table columns='[{"name":"col1","datatype":"number", "nullable":false}]' constraints='[{"name":"prim_key", "column_names":["col1"], "constraint_type":"PRIMARY KEY"}]' --database my_db --schema public
  

  Copy

• Erstellen Sie eine Datenbank mit der Option --json object-definition:

  snow object create database --json '{"name":"my_db", "comment":"Created with Snowflake CLI"}'
  

  Copy

• Erstellen Sie eine Tabelle mit der Option --json object-definition:

  snow object create table --json "$(cat table.json)" --database my_db
  

  Copy

  wobei table.json Folgendes enthält:

  {
    "name": "my_table",
    "columns": [
      {
        "name": "col1",
        "datatype": "number",
        "nullable": false
      }
    ],
    "constraints": [
      {
        "name": "prim_key",
        "column_names": ["col1"],
        "constraint_type": "PRIMARY KEY"
      }
    ]
  }
  

  Copy