Übersicht der Verbindungsparameter für den JDBC-Treiber¶

Gibt an, ob Unterstriche in Kontonamen zulässig sind. Der JDBC-Treiber unterstützt keine Unterstriche in URLs, die auch den Kontonamen enthalten. Daher konvertiert der JDBC-Treiber Unterstriche automatisch in Bindestriche. Der Standardwert ist false.

Gibt den Authentifikator an, der für die Überprüfung der Anmeldeinformationen des Benutzers verwendet werden soll. Sie können dies auf einen der folgenden Werte einstellen:

• snowflake, um den internen Snowflake-Authentifikator zu verwenden.

• externalbrowser, um den für Ihr Konto definierten Webbrowser für die Authentifizierung mit Okta, AD FS oder einem anderen SAML 2.0-kompatiblen Identitätsanbieter (IdP) zu verwenden.

• https://<Name_des_Okta-Kontos>.okta.com (d. h. der URL-Endpunkt für Okta) zum Authentifizieren über das systemeigene Okta (nur unterstützt, wenn Ihr IdP Okta ist).

• oauth zum Authentifizieren mit OAuth. Wenn OAuth als Authentifikator angegeben ist, müssen Sie auch den Parameter token festlegen, um das OAuth-Token anzugeben (siehe unten).

• snowflake_jwt, um die Schlüsselpaar-Authentifizierung zu verwenden. Weitere Informationen zur Schlüsselpaar-Authentifizierung finden Sie unter Verwenden von Schlüsselpaar-Authentifizierung und Schlüsselrotation.

• username_password_mfa zum Authentifizieren mit MFA-Tokencaching. Weitere Details dazu finden Sie unter Verwenden der mehrstufige Authentifizierung

Wenn die Verbindungszeichenfolge ein Schlüsselpaar angibt, wird die Schlüsselpaar-Authentifizierung auch dann verwendet, wenn der authenticator-Parameter nicht festgelegt oder auf „snowflake“ gesetzt ist.

Weitere Informationen zur Authentifizierung finden Sie unter Verwenden und Verwalten der Verbundauthentifizierung und Clients, Treiber und Konnektoren.

Gibt die Kennung an, die für die mehrstufige Authentifizierung verwendet werden soll.

Weitere Informationen zur mehrstufigen Authentifizierung finden Sie unter Mehrstufige Authentifizierung (MFA).

Gibt das Kennwort für den angegebenen Benutzer an.

Es gibt zwei Möglichkeiten, das Kennwort anzugeben:

• Die erste Möglichkeit besteht darin, Benutzer-ID und Kennwort direkt an die getConnection-Methode zu übergeben:

  String user = "<user>";          // replace "<user>" with your user name
  String password = "<password>";  // replace "<password>" with your password
  Connection con = DriverManager.getConnection("jdbc:snowflake://<account>.snowflakecomputing.com/", user, password);
  

  Copy

• Die zweite Möglichkeit besteht darin, ein Properties-Objekt zu erstellen, das Objekt mit dem Kennwort zu aktualisieren und das Objekt an die getConnection-Methode zu übergeben:

  String user = "<user>";          // replace "<user>" with your user name
  String password = "<password>";  // replace "<password>" with your password
  Properties props = new Properties();
  props.put("user", user);
  props.put("password", password);
  Connection con = DriverManager.getConnection("jdbc:snowflake://<account>.snowflakecomputing.com/", props);
  

  Copy

Gibt das OAuth-Token an, das für die Authentifizierung verwendet werden soll, wobei <Zeichenfolge> das Token ist. Dieser Parameter ist bis auf die unten beschrieben Ausnahme nur erforderlich, wenn Sie den Parameter authenticator auf oauth setzen.

Anstatt den token-Konfigurationsparameter festzulegen, können Sie beispielsweise das Token als Kennwort in den Eigenschaften der Methode getConnection() übergeben, ähnlich wie im Folgenden:

Properties props = new Properties();
props.put("user", "myusername");
props.put("authenticator", "oauth");
props.put("role", "myrole");
props.put("password", "xxxxxxxxxxxxx"); // where xxxxxxxxxxxxx is the token string
Connection myconnection = DriverManager.getConnection(url, props);

Gibt die Standarddatenbank an, die nach der Verbindung verwendet werden soll, oder eine leere Zeichenfolge. Die angegebene Datenbank sollte eine bestehende Datenbank sein, deren angegebene Standardrolle über entsprechende Berechtigungen verfügt.

Wenn Sie nach der Verbindung eine andere Datenbank verwenden müssen, führen Sie den Befehl USE DATABASE aus.

Gibt die Standardrolle für die Zugriffssteuerung an, die in der vom Treiber initiierten Snowflake-Sitzung verwendet werden soll. Die angegebene Rolle sollte eine bestehende Rolle sein, die dem angegebenen Benutzer des Treibers bereits zugeordnet wurde. Wenn die angegebene Rolle dem Benutzer noch nicht zugewiesen wurde, wird die Rolle beim Initiieren der Sitzung durch den Treiber nicht verwendet.

Wenn Sie nach der Verbindung eine andere Rolle verwenden müssen, führen Sie den Befehl USE ROLE aus.

Weitere Informationen zu Rollen und zur Zugriffssteuerung finden Sie unter Übersicht zur Zugriffssteuerung.

Gibt das Standardschema an, das nach dem Verbinden für die angegebene Datenbank verwendet werden soll, oder eine leere Zeichenfolge. Das angegebene Schema sollte ein bestehendes Schema sein, für das die angegebene Standardrolle über entsprechende Berechtigungen verfügt.

Wenn Sie nach der Verbindung ein anderes Schema verwenden müssen, führen Sie den Befehl USE SCHEMA aus.

Gibt das virtuelle Warehouse an, das nach dem Verbinden verwendet werden soll, oder eine leere Zeichenfolge. Das angegebene Warehouse sollte ein bestehendes Warehouse sein, für das die angegebene Standardrolle über entsprechende Berechtigungen verfügt.

Wenn Sie nach der Verbindung ein anderes Warehouse verwenden müssen, führen Sie den Befehl USE WAREHOUSE aus, um ein anderes Warehouse für die Sitzung festzulegen.

Gibt an, ob der Treiber die in den Java-Systemoptionen angegebene SOCKS-Proxykonfiguration ignorieren soll:

• on (oder true) gibt an, den Proxy zu ignorieren.

• off (oder false) oder ein anderer Wert gibt an, dass der Proxy verwendet werden soll.

Gibt an, ob der Treiber einen Proxy verwenden soll:

• on (oder true) gibt an, dass der Treiber einen Proxy verwenden soll.

• off (oder false) oder ein anderer Wert gibt an, dass der Treiber keinen Proxy verwenden soll.

Weitere Informationen dazu finden Sie unter Angeben eines Proxyservers in der JDBC-Verbindungszeichenfolge.