JDBC Driver for Snowflake

Build 24.0.8963

接続文字列オプション

接続文字列プロパティは、接続を確立するために使用できるさまざまなオプションです。このセクションでは、本プロバイダーの接続文字列で設定できるオプションの一覧を示します。詳細については各リンクをクリックしてください。

接続を確立する方法について詳しくは、接続の確立を参照してください。

Authentication


プロパティ説明
AuthSchemeThe authentication scheme used. Accepted entries are Password, OKTA, PrivateKey, AzureAD, AzureMSI, OAuth, PingFederate, or ExternalBrowser.
AccountThe Account provided for authentication with Snowflake database. This is usually derived from the URL automatically.
WarehouseThe name of the Snowflake warehouse.
UserThe username provided for authentication with the Snowflake database.
PasswordThe user's password.
URLThe URL of Snowflake database.
MFAPasscodeSpecifies the passcode to use for multi-factor authentication.
RoleNameThe role of the Snowflake user: PUBLIC, SYSADMIN, or ACCOUNTADMIN.
CredentialsLocationThe location of the settings file where credentials are saved.
AzureResourceThe Azure Active resource to authenticate to (used during Azure Managed Service Identity exchange).It should be set to the App Id URI.

Connection


プロパティ説明
UseVirtualHostingTrue(デフォルト)の場合、バケットはホスト形式のリクエストを使用してリクエストで参照されます:http://yourbucket.s3.amazonaws.com/yourobject。False に設定した場合、Bean はパス形式のリクエストを使用します:http://s3.amazonaws.com/yourbucket/yourobject。S3ベースのカスタムサービスの場合、CustomURL が指定されていると、このプロパティはFalse に設定されることに注意してください。

Azure Authentication


プロパティ説明
AzureTenantデータにアクセスするために使用されるMicrosoft Online テナント。指定しない場合は、デフォルトのテナントが使用されます。

SSO


プロパティ説明
ProofKeyThe ProofKey for authentication with Snowflake database. This is usually derived from GetSSOAuthorizationURL call.
ExternalTokenThe External Token for authentication with the Snowflake database. This is usually derived from the external handler. For example, handle the callback URL from procedure GetSSOAuthorizationURL will get this token.
SSOPropertiesAdditional properties required to connect to the identity provider in a semicolon-separated list.

KeyPairAuth


プロパティ説明
PrivateKeyThe private key provided for key pair authentication with Snowflake.
PrivateKeyPasswordThe password for the private key specified in the PrivateKey property, if required.
PrivateKeyTypeThe type of key store containing the private key to use with key pair authentication.
PrivateKeySubjectThe subject of the certificate containing the private key to use with key pair authentication.

OAuth


プロパティ説明
InitiateOAuth接続時にOAuth アクセストークンを取得またはリフレッシュするプロセスを開始するには、このプロパティを設定します。
OAuthClientIdOAuth 認証サーバーを使用してアプリケーションを登録する場合に割り当てられたクライアントId。
OAuthClientSecretOAuth 認証サーバーにアプリケーションを登録する場合に割り当てられたクライアントシークレット。
OAuthAccessTokenOAuth を使用して接続するためのアクセストークン。
CallbackURLThe OAuth callback URL to return to when authenticating. This value must match the callback URL you specify in your Add-In settings.
StateAn optional value that has meaning for your OAuth App.
OAuthSettingsLocationInitiateOAuth が GETANDREFRESH 、または REFRESH に設定されているときの設定ファイルの場所。代わりに、'memory://' で始まる値を指定することで、この場所をメモリに保持することができます。
OAuthAuthenticatorThis determines the authenticator that the OAuth application requests from Snowflake.
ScopeThis determines the scopes that the OAuth application requests from Snowflake.
OAuthAuthorizationURLOAuth サービスの認可URL。
OAuthAccessTokenURLOAuth アクセストークンを取得するURL。
OAuthVerifierOAuth 認可URL から返された検証コード。
PKCEVerifierA random value used as input for calling GetOAuthAccessToken in the PKCE flow.
OAuthRefreshToken対応するOAuth アクセストークンのためのOAuth リフレッシュトークン。
OAuthExpiresInOAuth アクセストークンの有効期限(秒単位)。
OAuthTokenTimestamp現在のアクセストークンが作成されたときのUnix エポックタイムスタンプ(ミリ秒)。

SSL


プロパティ説明
SSLServerCertTLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。

Firewall


プロパティ説明
FirewallTypeプロキシベースのファイアウォールで使われるプロトコル。
FirewallServerプロキシベースのファイアウォールの名前もしくはIP アドレス。
FirewallPortプロキシベースのファイアウォールのTCP ポート。
FirewallUserプロキシベースのファイアウォールに認証するために使うユーザー名。
FirewallPasswordプロキシベースのファイアウォールへの認証に使われるパスワード。

Proxy


プロパティ説明
ProxyAutoDetectこれは、システムプロキシ設定を使用するかどうかを示します。
ProxyServerHTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。
ProxyPortProxyServer プロキシが起動しているTCP ポート。
ProxyAuthSchemeProxyServer プロキシへの認証で使われる認証タイプ。
ProxyUserProxyServer プロキシへの認証に使われるユーザー名。
ProxyPasswordProxyServer プロキシへの認証に使われるパスワード。
ProxySSLTypeProxyServer プロキシへの接続時に使用するSSL タイプ。
ProxyExceptionsProxyServer 経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

Logging


プロパティ説明
Logfileログファイルの名前と場所を指定するファイルパス。
Verbosityログファイルの記述をどの程度の詳細さで記載するかを決定するverbosity レベル。
LogModulesログファイルに含めるコアモジュール。
MaxLogFileSizeログファイルの最大バイトサイズ(例えば、10MB)を指定する文字列。
MaxLogFileCountログファイルの最大ファイル数を指定する文字列。

Schema


プロパティ説明
Locationテーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。
BrowsableSchemasこのプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tablesこのプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。
Views使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。
DatabaseThe name of the Snowflake database.
SchemaThe schema of the Snowflake database.

Caching


プロパティ説明
AutoCacheSELECT クエリの結果を、 CacheLocation 、または CacheConnection と CacheProvider の両方で指定されたキャッシュデータベースに自動的にキャッシュします。
CacheDriverデータのキャッシュに使用されるデータベースドライバー。
CacheConnectionキャッシュデータベースの接続文字列。このプロパティは、常に CacheProvider と一緒に使用します。両プロパティを設定すると、データをキャッシュするための CacheLocation のバリューセットがオーバーライドされます。
CacheLocationキャッシュデータベースへのパスとファイル名を指定します。
CacheToleranceAutoCache 使用時のキャッシュ内の失効データに対する許容範囲の秒数。
Offlineオフラインモードを使用して、ライブソースではなくキャッシュからデータを取得します。
CacheMetadataこのプロパティは、テーブルメタデータをファイルストアにキャッシュするかどうかを決定します。

Miscellaneous


プロパティ説明
AllowPreparedStatementPrepare a query statement before its execution.
AllowUserVariablesWhen set to True, user variables (prefixed by an $) can be used in SQL queries.
ApplicationNameThe application name connection string property expresses the HTTP User-Agent.
AsyncQueryTimeoutThe timeout for asynchronous requests issued by the provider to download large result sets.
BatchModeAllow specifying the batch mode. Default: Auto.
BatchSize送信する各バッチ処理の最大サイズ。
BindingTypeAllow specifying the binding type for the Date, Time and Timestamp_* type.
ConnectionLifeTime接続の最大有効期間(秒単位)。その時間が経過すると、接続オブジェクトは削除されます。
ConnectOnOpenこのプロパティは、接続が開かれたときにSnowflake に接続するかどうかを指定します。
CustomStageThe name of a custom stage to use during bulk write operations.
ExternalStageAWSAccessKeyYour AWS account access key. Only used when defining a CustomStage for bulk write operations.
ExternalStageAWSSecretKeyYour AWS account secret key. Only used when defining a CustomStage for bulk write operations.
ExternalStageAzureSASTokenThe string value of the Azure Blob shared access signature.
IgnoreCaseWhether to ignore case in identifiers. Default: false.
IncludeTableTypesIf set to true, the provider will report the types of individual tables and views.
MaxRowsクエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。
MaxThreads同時リクエスト数を指定します。
MergeDeleteA boolean indicating whether batch DELETE statements should be converted to MERGE statements automatically. Only used when the DELETE statement's where clause contains a table's primary key field only and they are combined with AND logical operator.
MergeInsertA boolean indicating whether INSERT statements should be converted to MERGE statements automatically. Only used when the INSERT contains a table's primary key field.
MergeUpdateA boolean indicating whether batch UPDATE statements should be converted to MERGE statements automatically. Only used when the UPDATE statement's where clause contains a table's primary key field only and they are combined with AND logical operator.
Otherこれらの隠しプロパティは特定のユースケースでのみ使用されます。
PagesizeSnowflake から返されるページあたりの結果の最大数。
PoolIdleTimeout接続が閉じられる前に許容されたアイドル時間。
PoolMaxSizeプールの最大接続数。
PoolMinSizeプール内の最小接続数。
PoolWaitTime使用可能な接続を待機する最大秒数。
QueryPassthroughこのオプションは、クエリをSnowflake サーバーにas-is で渡します。
Readonlyこのプロパティを使用して、provider からSnowflake へのアクセスを読み取り専用に設定できます。
ReplaceInvalidUTF8CharsSpecifies whether to repalce invalid UTF8 characters with a '?'
RetryOnS3TimeoutWhether or not to retry when network issues occur at during chunk downloading.
RTKライセンス供与で使用されるランタイムキー。
S3DomainThe URI of the S3 bucket you are using as your Snowflake S3 stage.
SessionIdleTimeoutThe timeout minutes for Session, the values comes from Snowflake's session policy, which indicate the session policy parameter SESSION_IDLE_TIMEOUT_MINS. The default value is 240 minutes.
SessionParametersThe session parameters for Snowflake. For example: SessionParameters='QUERY_TAG=MyTag;QUOTED_IDENTIFIERS_IGNORE_CASE=True;';
Timeoutタイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
UseConnectionPoolingこのプロパティは、コネクションプーリングを有効にします。

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 24.0.8963