接続文字列オプション
接続文字列プロパティは、接続を確立するために使用できるさまざまなオプションです。このセクションでは、本プロバイダーの接続文字列で設定できるオプションの一覧を示します。詳細については各リンクをクリックしてください。
接続を確立する方法について詳しくは、接続の確立を参照してください。
| プロパティ | 説明 |
| AuthScheme | Google BigQuery への接続に使用する認証方法を指定します。 |
| ProjectId | Specifies the Google Cloud project used to resolve unqualified table names and execute jobs in Google BigQuery. |
| DatasetId | Specifies the dataset used to resolve unqualified table references in SQL queries. |
| BillingProjectId | Specifies the Project ID of the billing project used to execute Google BigQuery jobs. |
| プロパティ | 説明 |
| AllowLargeResultSets | Specifies whether large result sets are allowed to be stored in temporary tables. |
| DestinationTable | Specifies the Google BigQuery table where query results are stored. |
| UseQueryCache | Specifies whether to use Google BigQuery's built-in query cache for eligible queries. |
| PageSize | Specifies the number of results to return per page from Google BigQuery when paging through query results. |
| PollingInterval | Specifies the number of seconds to wait between status checks when polling for query completion. |
| UseLegacySQL | Specifies whether to use Google BigQuery's Legacy SQL dialect instead of Standard SQL when generating queries. |
| PrivateEndpointNameAccessTokenUrl | Specifies the custom endpoint name to use for retrieving an OAuth authorization Url when connecting with Private Service Connect. |
| PrivateEndpointNameAuthUrl | Specifies the custom endpoint name to use for retrieving an OAuth authorization Url when connecting with Private Service Connect. |
| PrivateEndpointNameCloudStorage | Specifies the custom endpoint name to use for Google Cloud Storage when connecting with Private Service Connect. |
| PrivateEndpointNameBigQuery | Specifies the custom endpoint name to use for the REST API when connecting with Private Service Connect. |
| PrivateEndpointNameStorage | Specifies the custom endpoint name to use for the Storage Read API when connecting with Private Service Connect. |
| PrivateEndpointNameSts | Specifies the custom endpoint name to use for STS when connecting with Private Service Connect. |
| プロパティ | 説明 |
| UseStorageAPI | Specifies whether to use the Google BigQuery Storage API for bulk data reads instead of the standard REST API. |
| UseArrowFormat | Specifies whether to use the Arrow format instead of Avro when reading data through the Google BigQuery Storage API. |
| StorageThreshold | Specifies the minimum number of rows a query must return for the provider to use the Google BigQuery Storage API to read results. |
| StoragePageSize | Specifies the number of rows to buffer per page when executing queries using the Google BigQuery Storage API. |
| StorageTimeout | Specifies the maximum time, in seconds, that a Storage API connection may remain active before the provider resets the connection. |
| プロパティ | 説明 |
| InsertMode | Specifies the method used to insert data into Google BigQuery. |
| WaitForBatchResults | Specifies whether the provider should wait for Google BigQuery batch load jobs to complete before returning from an INSERT operation. |
| GCSBucket | Specifies the name of the Google Cloud Storage (GCS) bucket where bulk data is uploaded for staging. |
| GCSBucketFolder | Specifies the name of the folder within the GCS bucket where bulk data is uploaded for staging. |
| TempTableDataset | Specifies the prefix of the dataset used to store temporary tables during bulk UPDATE or DELETE operations. |
| プロパティ | 説明 |
| InitiateOAuth | OAuth アクセストークンを取得またはリフレッシュするプロセスを指定します。これにより、認証された認可ユーザーが作業している間、ユーザーアクセスを維持することができます。 |
| OAuthClientId | カスタムOAuth アプリケーションに割り当てられたクライアントID（コンシューマーキーとも呼ばれます）を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。 |
| OAuthClientSecret | カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。（カスタムOAuth アプリケーションのみ） |
| OAuthAccessToken | データソースへのリクエストを認証するために使用されるOAuth アクセストークンを指定します。このトークンは、OAuth 交換が正常に完了した後に認可サーバーから発行されます。 |
| DelegatedServiceAccounts | 委任されたリクエストのためのサービスアカウントE メールをスペース区切りで指定します。 |
| RequestingServiceAccount | 委任されたリクエストを行うためのサービスアカウントのE メールを指定します。 |
| OAuthSettingsLocation | OAuth 値が保存される設定ファイルの場所を指定します。 |
| CallbackURL | OAuth 経由でGoogle BigQuery への認証を行った後にユーザーが戻るURL を指定します（カスタムOAuth アプリケーションのみ）。 |
| Scope | Specifies the OAuth scopes requested by the provider. Scopes are space-delimited and determine the level of access to Google APIs. |
| OAuthVerifier | OAuthAuthorizationURL から返された検証コードを指定します。ブラウザを起動できないヘッドレスサーバーでOAuth 認証を行う場合に使用します。 OAuthSettingsLocation および OAuthVerifier の両方が設定される必要があります。 |
| OAuthRefreshToken | 元のアクセストークンが期限切れになった後に新しいアクセストークンを要求するために使用される、OAuth リフレッシュトークンを指定します。 |
| OAuthExpiresIn | OAuth アクセストークンの有効期間を秒単位で指定します。ユーザーが操作を続けている限り、アクセスを維持するためにトークンを再発行することができます。 |
| OAuthTokenTimestamp | 現在のアクセストークンがいつ作成されたかを示すUnix エポックタイムスタンプをミリ秒単位で表示します。 |
| プロパティ | 説明 |
| OAuthJWTCert | クライアント証明書のJWT 証明書ストアの名前を指定します。 |
| OAuthJWTCertType | JWT 証明書を格納しているキーストアの種類を指定します。 |
| OAuthJWTCertPassword | パスワードで保護された証明書ストアにアクセスするために使用されるOAuth JWT 証明書のパスワードを指定します。証明書ストアがパスワードを必要としない場合は、このプロパティを空白のままにします。 |
| OAuthJWTCertSubject | ストアで一致する証明書を検索するために使用される、OAuth JWT 証明書のサブジェクトを指定します。部分一致と、先頭の証明書を選択するためのワイルドカード '*' をサポートします。 |
| OAuthJWTIssuer | Java Web Token の発行者。 |
| OAuthJWTSubject | アプリケーションからデリゲートアクセスの要求対象となるユーザーサブジェクト。 |
| プロパティ | 説明 |
| SSLServerCert | TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。 |
| プロパティ | 説明 |
| FirewallType | provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。 |
| FirewallServer | ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。 |
| FirewallPort | プロキシベースのファイアウォールで使用するTCP ポートを指定します。 |
| FirewallUser | プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。 |
| FirewallPassword | プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。 |
| プロパティ | 説明 |
| ProxyAutoDetect | provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。 |
| ProxyServer | HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレスを指定します。 |
| ProxyPort | クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバーのTCP ポートを指定します。 |
| ProxyAuthScheme | ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。 |
| ProxyUser | ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名を提供します。 |
| ProxyPassword | ProxyUser 接続プロパティで指定されたユーザーのパスワードを指定します。 |
| ProxySSLType | ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプを指定します。 |
| ProxyExceptions | ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリストを指定します。 |
| プロパティ | 説明 |
| Logfile | provider が認証、クエリ実行、接続の詳細などのアクティビティを記録するログファイルのファイルパスを指定します。 |
| Verbosity | ログファイルのVerbosity レベルを指定し、記録される情報の詳細度を制御します。サポートされる値の範囲は1から5までです。 |
| LogModules | ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。 |
| MaxLogFileSize | 単一のログファイルの最大サイズをバイト単位で指定します。例えば、'10 MB' です。ファイルが上限に達すると、provider は日付と時刻を名前に付加した新しいログファイルを作成します。 |
| MaxLogFileCount | provider が保持するログファイルの最大数を指定します。上限に達すると、最も古いログファイルが削除され、新しいログファイルのためのスペースが作られます。 |
| プロパティ | 説明 |
| Location | テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。 |
| BrowsableSchemas | レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。 |
| BrowsableCatalogs | Optional setting that restricts the catalogs reported to a subset of all available catalogs. For example, BrowsableCatalogs=CatalogA,CatalogB,CatalogC . |
| Tables | レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。 |
| Views | レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。 |
| RefreshViewSchemas | Specifies whether the provider should automatically refresh view schemas by querying the views directly. |
| ShowTableDescriptions | Specifies whether table descriptions are returned through platform metadata APIs and system views like sys_tables and sys_views. |
| PrimaryKeyIdentifiers | Specifies rules for assigning primary keys to tables. |
| AllowedTableTypes | Specifies which types of tables are visible when listing tables in the dataset. |
| FlattenObjects | Specifies whether STRUCT fields in Google BigQuery are flattened into individual top-level columns. |
| プロパティ | 説明 |
| AutoCache | SELECT クエリの対象となるテーブルの内容が、指定されたキャッシュデータベースに自動的にキャッシュされるかどうかを指定します。 |
| CacheProvider | ADO.NET プロバイダーの名前空間。指定されたプロバイダーは、すべてのキャッシュ操作のターゲットデータベースとして使用されます。 |
| CacheDriver | JDBC ドライバーのドライバークラス。指定されたドライバーは、すべてのキャッシュ操作のためにターゲットデータベースに接続するために使用されます。 |
| CacheConnection | 指定されたキャッシュデータベースの接続文字列を指定します。 |
| CacheLocation | キャッシュデータベースへのパスとファイル名を指定します。 |
| CacheTolerance | 指定されたキャッシュデータベース内の失効データに対する許容時間（秒単位）を指定します。AutoCache がTrue に設定されている必要があります。 |
| Offline | ライブGoogle BigQuery データの代わりに、指定されたキャッシュデータベースからデータを取得します。 |
| CacheMetadata | provider がテーブルメタデータをファイルベースのキャッシュデータベースにキャッシュするかどうかを決定します。 |
| プロパティ | 説明 |
| AllowAggregateParameters | Specifies whether raw aggregate values can be used in parameters when the QueryPassthrough connection property is enabled. |
| ApplicationName | Specifies the name of the application using the provider, in the format application/version. For example, AcmeReporting/1.0. |
| AuditLimit | Specifies the maximum number of rows that can be stored in the in-memory audit table. |
| AuditMode | Specifies which provider actions should be recorded in audit tables. |
| AWSWorkloadIdentityConfig | AWS 経由でWorkload Identity Federation を使用する場合に指定する設定プロパティ。 |
| AzureWorkloadIdentityConfig | Azure 経由でWorkload Identity Federation を使用する場合に指定する設定プロパティ。 |
| BigQueryOptions | Specifies a comma-separated list of custom Google BigQuery provider options. |
| EmptyArraysAsNull | Specifies whether empty arrays are represented as null or as an empty array. |
| GenerateSchemaFiles | スキーマを生成して保存するユーザーの好みのタイミングを示します。 |
| HidePartitionColumns | Specifies whether the pseudocolumns _PARTITIONDATE and _PARTITIONTIME are hidden in partitioned tables. |
| MaximumBillingTier | Specifies the maximum billing tier for a query, represented as a positive integer multiplier of the standard cost per terabyte. |
| MaximumBytesBilled | Specifies the maximum number of bytes a Google BigQuery job is allowed to process before it is cancelled. |
| MaxRows | 集計やGROUP BY を含まないクエリで返される最大行数を指定します。 |
| Other | 特定のユースケースに対する追加の隠しプロパティを指定します。特定の問題に対処するため、サポートチームが推奨する場合にのみ使用してください。詳細は備考を参照してください。 |
| PseudoColumns | テーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。 |
| QueryPassthrough | このオプションは、クエリをGoogle BigQuery サーバーにas-is で渡します。 |
| Readonly | provider からGoogle BigQuery への読み取り専用アクセスを切り替えます。 |
| RTK | provider のライセンスを取得するためのランタイムキーを指定します。設定されていないか無効な場合、provider は標準のライセンス方法をデフォルトとして使用します。このプロパティは、標準のライセンス方法がサポートされていないか、ランタイムキーが必要な環境でのみ必要です。 |
| SupportCaseSensitiveTables | Specifies whether the provider distinguishes between tables and datasets with the same name but different casing. |
| TableSamplePercent | Specifies the percentage of each table to sample when generating queries using the TABLESAMPLE clause. |
| Timeout | Specifies the maximum number of seconds to wait before timing out an operation. |
| UserDefinedViews | カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。 |
| WorkloadPoolId | Workload Identity Federation プールのID。 |
| WorkloadProjectId | Workload Identity Federation プールをホストするGoogle Cloud プロジェクトのID。 |
| WorkloadProviderId | Workload Identity Federation プールプロバイダーのID。 |