CData Cloud は、クラウドホスト型のソリューションで、複数の標準サービスやプロトコルにまたがるGoogle Sheets へのアクセスを実現します。MySQL またはSQL Server データベースに接続できるアプリケーションであれば、CData Cloud を介してGoogle Sheets に接続できます。
CData Cloud により、他のOData エンドポイントや標準SQL Server / MySQL データベースと同じように、Google Sheets への接続を標準化し、構成することができます。
このページでは、CData Cloud でのGoogle Sheets への接続の確立 のガイド、利用可能なリソースに関する情報、および使用可能な接続プロパティのリファレンスについて説明します。
接続の確立 は、CData Cloud にデータベースを作成するためのGoogle Sheets への認証方法と必要な接続プロパティの設定方法について示します。
利用可能な標準サービスを経由してGoogle Sheets からデータにアクセスする方法と、CData Cloud の管理については、CData Cloud ドキュメント で詳しく説明します。
Database タブで対応するアイコンを選択して、Google Sheets に接続します。必須プロパティはSettings にリストされています。Advanced タブには、通常は必要ない接続プロパティが表示されます。
アクセス | AuthScheme | 注記 |
ユーザーアカウント | OAuth | デスクトップアプリケーションからアクセスする場合は、埋め込みクレデンシャルを使用できます。後述の「デスクトップアプリケーション」を参照してください。 |
サービスアカウント | OAuthJWT | データがJSON かPFX ファイルかによって異なります。後述の「サービスとして認証」を参照してください。 |
GCP インスタンスアカウント | GCPInstanceAccount | GCP 仮想マシン上で使用します。 |
API キー | Token | APIKey をTrue に設定します。 Google Cloud コンソールでAPI キーを作成するには、認証情報を作成 -> API キーをクリックします。本番環境で使用する前にキーを制限するには、アプリケーションの制限を選択して使用可能な制限の1つを選択します。。 |
以下のセクションでは、ユーザーとしての認証とサービスとしての認証について説明します。
以下のサブセクションでは、3つの一般的な認証フローを経由したユーザーアカウント(AuthScheme OAuth)からGoogle Sheets への認証方法について詳しく説明します。
カスタムOAuth アプリケーションの作成についての情報と、埋め込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、カスタムOAuth アプリケーションの作成 を参照してください。 Google Sheets で利用可能な接続文字列プロパティの全リストは、Connection を参照してください。
アクセストークンの期限が切れたときは、Cloud は自動でアクセストークンをリフレッシュします。
OAuth アクセストークンの自動リフレッシュ:
Cloud がOAuth アクセストークンを自動的にリフレッシュするようにするには、次のように設定します。
OAuth アクセストークンの手動リフレッシュ:
OAuth アクセストークンを手動でリフレッシュするために必要な唯一の値は、OAuth リフレッシュトークンです。
OAuth リフレッシュトークンを保存し、OAuth アクセストークンの有効期限が切れた後に手動でリフレッシュできるようにします。
(OAuthAccessToken およびその他の設定パラメータを取得および設定する方法についての情報は、「Google Sheets への接続」の デスクトップ認証セクションを参照してください。)
ただし、Web 経由で接続するユーザー、およびユーザーの代わりにサービスアカウント経由で接続する場合は、カスタムOAuth 接続が必要になります。カスタムOAuth アプリケーションは、次のような場合にも有用です。
アプリケーションの作成が完了すると、Cloud コンソールは認証情報ページに戻ります。 ウィンドウが開き、クライアントId とクライアントシークレットが表示されます。
クライアントシークレットはGoogle Cloud コンソールからアクセス可能ですが、クライアントシークレットをメモしておくことをお勧めします。OAuthClientId とOAuthClientSecretを指定するには、クライアントシークレットとクライアントId の両方が必要です。
AuthScheme=OAuthJWT を使用する場合、サービスアカウントを作成する必要があります。
Google Cloud Console で:
キーは自動的にローカルデバイスにダウンロードされ、キーに固有の追加情報が表示されます。
デフォルトでは、Cloud はサーバーの証明書をシステムの信頼できる証明書ストアと照合してSSL / TLS のネゴシエーションを試みます。
別の証明書を指定するには、利用可能なフォーマットについてSSLServerCert プロパティを参照してください。
Windows のシステムプロキシ経由の接続では、接続プロパティを追加で設定する必要はありません。他のプロキシに接続するには、ProxyAutoDetect をfalse に設定します。
さらにHTTP プロキシへの認証には、ProxyServer とProxyPort に加えてProxyAuthScheme、ProxyUser、およびProxyPassword を設定します。
次のプロパティを設定します。
Cloud は、スプレッドシートおよび範囲をリレーショナルテーブルとしてモデル化します。
テーブル は、スプレッドシートの構成をテーブルに反映するためのさまざまな設定オプションを示します。例えば、ヘッダーを操作する方法や、範囲をテーブルとしてクエリする方法を見つけることができます。
カラム では、列検出に関する詳細情報を提供しています。
Cloud では、左上に揃えて配置されたスプレッドシートまたはユーザー指定の範囲をデータベーステーブルとして表すことができます。Header プロパティを設定することで、テーブルをどのようにリストするかを制御できます。
Google Spreadsheet API の制限により、すべての列ヘッダーは空白にはできません。
Note:範囲指定は、SELECT ステートメントとUPDATE ステートメントでのみ使用できます。DELETE コマンドとINSERT コマンドは範囲をサポートしていません。
Header プロパティを設定することで、列名を指定するか、列名を自動的に生成することができます。このプロパティは、コマンドで列を使用する方法に影響します。
ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。
クエリは、ビューに対して通常のテーブルと同様に実行することができます。
Name | Description |
Folders | ユーザーのGoogle Drive に含まれるフォルダのクエリ。 |
Sheets | ユーザーのスプレッドシートとその関連情報のリストを返します。 |
Spreadsheets | ユーザーのスプレッドシートとその関連情報のリストを返します。 |
ユーザーのGoogle Drive に含まれるフォルダのクエリ。
Cloud はGoogle Sheets API を使用して、サーバーサイドでサポートされているカラムおよび演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでCloud 内部で処理されます。
サーバーサイドのフィルタリングをサポートするカラムと演算子は以下のとおりです。
Note: 特定のドライブからクエリするには、SupportsAllDrives 接続プロパティを'true' に設定する必要があります。
サーバーサイドのフィルタリングをサポートするすべてのカラムは、AND およびOR 論理演算子と組み合わせることができます。例えば、次のクエリはサーバーサイドで処理されます。
SELECT * FROM Folders WHERE Name = 'example folder'
SELECT * FROM Folders WHERE OwnerEmail IN ('[email protected]', '[email protected]') AND ModifiedTime >= '2020-04-01T05:30:00'
Name | Type | Description |
Id [KEY] | String | フォルダのID。 |
Name | String | フォルダ名。これはフォルダ内で必ずしも一意である必要はありません。Team Drives のトップレベルフォルダ、My Drive ルートファイル、Application Data フォルダなどの不変のアイテムは名前が変わることはないので注意してください。 |
DriveId | String | ドライブのId。 |
Description | String | フォルダの簡単な説明。. |
CreatedTime | Datetime | フォルダの作成日。 |
ModifiedTime | Datetime | ファイルまたはフォルダの最終変更日。 |
Size | Long | フォルダのサイズ(バイト)。 |
OwnerName | String | リソースオーナーの名前。 |
OwnerEmail | String | リソースオーナーのE メール。 |
Starred | Boolean | このフィールドは、リソースがスター付きかどうかを設定します。 |
Trashed | Boolean | このフィールドは、リソースがごみ箱に移動されたかどうかを設定します。 |
Viewed | Boolean | このフィールドは、リソースが現在のユーザーによって表示されたかどうかを設定します。 |
ParentIds | String | 親フォルダーIDのカンマ区切りリスト。 |
ChildIds | String | 子リソースID のセミコロン区切りリスト。 |
ChildLinks | String | 子リソースリンクのセミコロン区切りリスト。 |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
Name | Type | Description |
Query | String | このフィールドは、有効なGoogle ドライブSDK クエリを受け入れ、WHERE 句の条件をオーバーライドします。 |
ユーザーのスプレッドシートとその関連情報のリストを返します。
Name | Type | Description |
SpreadsheetId | String | スプレッドシートに割り当てられたID。 |
SpreadsheetName | String | スプレッドシートの名前。 |
SheetId | String | シートに割り当てられたID。 |
SheetName | String | シートの名前。 |
SheetIndex | Integer | スプレッドシート内のシートのインデックス。 |
SheetType | String | シートのタイプ。デフォルトはGRID です。 |
Hidden | Boolean | UI でシートを非表示にするかどうかを指定します。 |
RowCount | Integer | グリッド内の行の数。 |
ColumnCount | Integer | グリッド内のカラムの数。 |
FrozenRowCount | Integer | グリッド内の固定された行の数。 |
FrozenColumnCount | Integer | グリッド内の固定された行の数。 |
DataSourceExecutionStatus | String | DataSource シートの実行状況。 |
ユーザーのスプレッドシートとその関連情報のリストを返します。
Name | Type | Description |
Id [KEY] | String | スプレッドシートに割り当てられたID。 |
Name | String | スプレッドシートの名前。 |
Description | String | スプレッドシートの簡単な説明。 |
OwnerName | String | スプレッドシートのオーナー名。 |
OwnerEmail | String | スプレッドシートのオーナーのE メール。 |
ModifiedTime | Datetime | このスプレッドシートの最終更新日時。 |
CreatedTime | Datetime | スプレッドシートの作成日時。 |
Trashed | Boolean | スプレッドシートが削除されたかどうか。 |
Starred | Boolean | ユーザーがスプレッドシートに星を付けたかどうか。 |
Viewed | Boolean | ユーザーがスプレッドシートを参照したかどうか。 |
ParentIds | String | 親フォルダID のカンマ区切りリスト。 |
ストアドプロシージャはファンクションライクなインターフェースで、Google Sheets の単純なSELECT/INSERT/UPDATE/DELETE 処理にとどまらずCloud の機能を拡張します。
ストアドプロシージャは、パラメータのリストを受け取り、目的の機能を実行し、プロシージャが成功したか失敗したかを示すとともにGoogle Sheets から関連するレスポンスデータを返します。
Name | Description |
AddDataSource | 指定したスプレッドシートにBigQuery dataSource を追加します。このストアドプロシージャを実行するには、スコープがbigquery.readonly のカスタムOAuth アプリが必要です。 |
AddDataSourceTable | シートにDataSource Table を追加します。このストアドプロシージャを実行するには、スコープがbigquery.readonly のカスタムOAuth アプリが必要です。 |
AddSheet | 既存のGoogle スプレッドシートにワークシートを追加します。 |
CopySheet | スプレッドシートから別のスプレッドシートにシートをコピーします。 |
CreateSpreadsheet | ユーザーのGoogle Drive にスプレッドシートを作成します。 |
DeleteSheet | 既存のGoogle スプレッドシート内のワークシートを削除します。 |
DeleteSpreadsheet | スプレッドシートを削除します。 |
FormatRange | 特定の範囲のセルをフォーマットします。 |
UpdateSheet | 指定されたSpreadsheetId およびSheetId のシートのプロパティを更新します。 |
指定したスプレッドシートにBigQuery dataSource を追加します。このストアドプロシージャを実行するには、スコープがbigquery.readonly のカスタムOAuth アプリが必要です。
Name | Type | Description |
SpreadsheetId | String | スプレッドシートのID。 |
ProjectId | String | BigQuery が有効なGCP プロジェクトのID。 |
TableProjectId | String | テーブルが属するBigQuery プロジェクトのID。指定がない場合は、projectId とみなされます。 |
DatasetId | String | BigQuery のデータセットId。 |
TableId | String | BigQuery のテーブルId。 |
BigQueryQuery | String | DataSource へのクエリ時に使用するクエリ。 |
Name | Type | Description |
Success | String | この値は、操作が成功したかどうかを示します。 |
DataSourceId | String | 作成されたDataSouce のID。 |
Status | String | DataExecution ステータス。 |
シートにDataSource Table を追加します。このストアドプロシージャを実行するには、スコープがbigquery.readonly のカスタムOAuth アプリが必要です。
Name | Type | Description |
SpreadsheetId | String | テーブルが作成されるスプレッドシートのID。 |
DataSourceId | String | DataSource のID。 |
SheetId | String | テーブルが取り込まれるシートのID。指定がない場合は0とみなされます。
The default value is 0. |
RowLimit | String | 返す行の上限。設定されていない場合、デフォルトの制限が適用されます。 |
Range | String | dataTable が取り込まれる範囲。例:A1:G10 |
RefreshDatasourceMode | String | datasource テーブルを作成した後にリフレッシュします。DATASOURCEID - datasource のすべての関連データソースオブジェクトをリフレッシュします。ISALL - スプレッドシート内の既存のデータソースオブジェクトをすべてリフレッシュします。NONE - datasource テーブルをリフレッシュしません。
The allowed values are DATASOURCEID, ISALL, NONE. The default value is DATASOURCEID. |
Name | Type | Description |
Success | String | この値は、操作が成功したかどうかを示します。 |
既存のGoogle スプレッドシートにワークシートを追加します。
Name | Type | Description |
SpreadsheetId | String | スプレッドシートのID。 |
SheetId | String | シートのID。これはnon-negative である必要があります。このフィールドは一度設定した後は変更ができません。 |
Title | String | シートの名前。 |
Index | String | スプレッドシート内のシートのインデックス。 |
SheetType | String | シートのタイプ。デフォルトはGRID です。このフィールドは一度設定した後は変更ができません。
The allowed values are GRID, OBJECT. The default value is GRID. |
RowCount | String | グリッド内の行数。 |
ColumnCount | String | グリッド内のカラムの数。 |
FrozenRowCount | String | グリッド内の固定された行の数。 |
FrozenColumnCount | String | グリッド内の固定されたカラムの数。 |
HideGridlines | Boolean | UI でグリッドが罫線を表示している場合にはTrue。 |
Hidden | Boolean | UI でシートが非表示の場合はTrue、表示の場合はFalse。 |
RightToLeft | Boolean | シートがLTR シートではなく、RTL シートの場合はTrue。 |
Name | Type | Description |
Success | String | この値は、操作が成功したかどうかを示します。 |
スプレッドシートから別のスプレッドシートにシートをコピーします。
Name | Type | Description |
SpreadsheetId | String | コピーするシートを含むスプレッドシートのID。 |
SheetId | String | コピーするシートのID。 |
DestinationSpreadsheetId | String | コピー先のスプレッドシートのID。 |
SheetName | String | 任意のパラメータ。新しく作成したシートに設定する新しい名前。 |
Name | Type | Description |
Success | String | この値は、操作が成功したかどうかを示します。 |
SheetId | String | 新しく作成したシートのID。 |
ユーザーのGoogle Drive にスプレッドシートを作成します。
Name | Type | Description |
Title | String | スプレッドシートのタイトル。 |
Description | String | スプレッドシートの説明。 |
Hidden | Boolean | このパラメータはリソースが隠されるかどうかを定義します。
The default value is FALSE. |
Restricted | Boolean | このパラメータはリソースが制限されるかどうかを定義します。
The default value is FALSE. |
Starred | Boolean | このパラメータはリソースに星がつくかどうかを定義します。
The default value is FALSE. |
Parents | String | 作成されたスプレッドシートの親フォルダのId。 |
Name | Type | Description |
Success | String | このパラメータは、操作が正常に完了したかどうかを示します。 |
Id | String | 新しいスプレッドシートのId。 |
既存のGoogle スプレッドシート内のワークシートを削除します。
Name | Type | Description |
SpreadsheetId | String | スプレッドシートのID。 |
SheetId | String | シートのID。 |
Name | Type | Description |
Success | String | この値は、操作が成功したかどうかを示します。 |
スプレッドシートを削除します。
Name | Type | Description |
SpreadsheetId | String | スプレッドシートのID。 |
Name | Type | Description |
Success | String | この値は、操作が成功したかどうかを示します。 |
特定の範囲のセルをフォーマットします。
Name | Type | Description |
SpreadsheetId | String | スプレッドシートのID。 |
SheetId | String | シートのID。これはnon-negative である必要があります。 |
Range | String | フォーマットするセルの範囲。フォーマットは、例えば、A1:C3 でなければなりません。 |
BackgroundColor | String | 赤、緑、青のRGB 値を指定して背景色を指定します。例えば、255,0,0 です。 |
Bold | String | セルのテキストをボールドにします。true またはfalse を許容します。 |
FontSize | String | int 値を指定してフォントサイズを設定します。 |
FontFamily | String | 名前を指定して使用するフォントを設定します。 |
Name | Type | Description |
Success | String | この値は、操作が成功したかどうかを示します。 |
指定されたSpreadsheetId およびSheetId のシートのプロパティを更新します。
Name | Type | Description |
SpreadsheetId | String | スプレッドシートのID。 |
SheetId | String | シートのID。これはnon-negative である必要があります。 |
Title | String | シートの名前。 |
Index | String | スプレッドシート内のシートのインデックス。 |
RowCount | String | グリッド内の行数。 |
ColumnCount | String | グリッド内のカラムの数。 |
FrozenRowCount | String | グリッド内の固定された行の数。 |
FrozenColumnCount | String | グリッド内の固定されたカラムの数。 |
HideGridlines | Boolean | UI でグリッドが罫線を表示している場合にはTrue。 |
Hidden | Boolean | UI でシートが非表示の場合はTrue、表示の場合はFalse。 |
RightToLeft | Boolean | シートがLTR シートではなく、RTL シートの場合はTrue。 |
Name | Type | Description |
Success | String | この値は、操作が成功したかどうかを示します。 |
このセクションで説明されているシステムテーブルをクエリして、スキーマ情報、データソース機能に関する情報、およびバッチ操作の統計にアクセスできます。
以下のテーブルは、Google Sheets のデータベースメタデータを返します。
以下のテーブルは、データソースへの接続方法およびクエリ方法についての情報を返します。
次のテーブルは、データ変更クエリ(バッチ処理を含む)のクエリ統計を返します。
利用可能なデータベースをリストします。
次のクエリは、接続文字列で決定されるすべてのデータベースを取得します。
SELECT * FROM sys_catalogs
Name | Type | Description |
CatalogName | String | データベース名。 |
利用可能なスキーマをリストします。
次のクエリは、すべての利用可能なスキーマを取得します。
SELECT * FROM sys_schemas
Name | Type | Description |
CatalogName | String | データベース名。 |
SchemaName | String | スキーマ名。 |
利用可能なテーブルをリストします。
次のクエリは、利用可能なテーブルおよびビューを取得します。
SELECT * FROM sys_tables
Name | Type | Description |
CatalogName | String | テーブルまたはビューを含むデータベース。 |
SchemaName | String | テーブルまたはビューを含むスキーマ。 |
TableName | String | テーブル名またはビュー名。 |
TableType | String | テーブルの種類(テーブルまたはビュー)。 |
Description | String | テーブルまたはビューの説明。 |
IsUpdateable | Boolean | テーブルが更新可能かどうか。 |
利用可能なテーブルおよびビューのカラムについて説明します。
次のクエリは、Spreadsheet1_Sheet1 テーブルのカラムとデータ型を返します。
SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Spreadsheet1_Sheet1'
Name | Type | Description |
CatalogName | String | テーブルまたはビューを含むデータベースの名前。 |
SchemaName | String | テーブルまたはビューを含むスキーマ。 |
TableName | String | カラムを含むテーブルまたはビューの名前。 |
ColumnName | String | カラム名。 |
DataTypeName | String | データ型の名前。 |
DataType | Int32 | データ型を示す整数値。この値は、実行時に環境に基づいて決定されます。 |
Length | Int32 | カラムのストレージサイズ。 |
DisplaySize | Int32 | 指定されたカラムの通常の最大幅(文字数)。 |
NumericPrecision | Int32 | 数値データの最大桁数。文字データおよび日時データの場合は、カラムの長さ(文字数)。 |
NumericScale | Int32 | カラムのスケール(小数点以下の桁数)。 |
IsNullable | Boolean | カラムがNull を含められるかどうか。 |
Description | String | カラムの簡単な説明。 |
Ordinal | Int32 | カラムのシーケンスナンバー。 |
IsAutoIncrement | String | カラムに固定増分値が割り当てられるかどうか。 |
IsGeneratedColumn | String | 生成されたカラムであるかどうか。 |
IsHidden | Boolean | カラムが非表示かどうか。 |
IsArray | Boolean | カラムが配列かどうか。 |
IsReadOnly | Boolean | カラムが読み取り専用かどうか。 |
IsKey | Boolean | sys_tablecolumns から返されたフィールドがテーブルの主キーであるかどうか。 |
利用可能なストアドプロシージャをリストします。
次のクエリは、利用可能なストアドプロシージャを取得します。
SELECT * FROM sys_procedures
Name | Type | Description |
CatalogName | String | ストアドプロシージャを含むデータベース。 |
SchemaName | String | ストアドプロシージャを含むスキーマ。 |
ProcedureName | String | ストアドプロシージャの名前。 |
Description | String | ストアドプロシージャの説明。 |
ProcedureType | String | PROCEDURE やFUNCTION などのプロシージャのタイプ。 |
ストアドプロシージャパラメータについて説明します。
次のクエリは、DownloadDocument ストアドプロシージャのすべての入力パラメータについての情報を返します。
SELECT * FROM sys_procedureparameters WHERE ProcedureName='DownloadDocument' AND Direction=1 OR Direction=2
Name | Type | Description |
CatalogName | String | ストアドプロシージャを含むデータベースの名前。 |
SchemaName | String | ストアドプロシージャを含むスキーマの名前。 |
ProcedureName | String | パラメータを含むストアドプロシージャの名前。 |
ColumnName | String | ストアドプロシージャパラメータの名前。 |
Direction | Int32 | パラメータのタイプに対応する整数値:input (1)。input/output (2)、またはoutput(4)。input/output タイプパラメータは、入力パラメータと出力パラメータの両方になれます。 |
DataTypeName | String | データ型の名前。 |
DataType | Int32 | データ型を示す整数値。この値は、実行時に環境に基づいて決定されます。 |
Length | Int32 | 文字データの場合は、許可される文字数。数値データの場合は、許可される桁数。 |
NumericPrecision | Int32 | 数値データの場合は最大精度。文字データおよび日時データの場合は、カラムの長さ(文字数)。 |
NumericScale | Int32 | 数値データの小数点以下の桁数。 |
IsNullable | Boolean | パラメータがNull を含められるかどうか。 |
IsRequired | Boolean | プロシージャの実行にパラメータが必要かどうか。 |
IsArray | Boolean | パラメータが配列かどうか。 |
Description | String | パラメータの説明。 |
Ordinal | Int32 | パラメータのインデックス。 |
主キーおよび外部キーについて説明します。
次のクエリは、Spreadsheet1_Sheet1 テーブルの主キーを取得します。
SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Spreadsheet1_Sheet1'
Name | Type | Description |
CatalogName | String | キーを含むデータベースの名前。 |
SchemaName | String | キーを含むスキーマの名前。 |
TableName | String | キーを含むテーブルの名前。 |
ColumnName | String | キーカラムの名前 |
IsKey | Boolean | カラムがTableName フィールドで参照されるテーブル内の主キーかどうか。 |
IsForeignKey | Boolean | カラムがTableName フィールドで参照される外部キーかどうか。 |
PrimaryKeyName | String | 主キーの名前。 |
ForeignKeyName | String | 外部キーの名前。 |
ReferencedCatalogName | String | 主キーを含むデータベース。 |
ReferencedSchemaName | String | 主キーを含むスキーマ。 |
ReferencedTableName | String | 主キーを含むテーブル。 |
ReferencedColumnName | String | 主キーのカラム名。 |
外部キーについて説明します。
次のクエリは、他のテーブルを参照するすべての外部キーを取得します。
SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'
名前 | タイプ | 説明 |
CatalogName | String | キーを含むデータベースの名前。 |
SchemaName | String | キーを含むスキーマの名前。 |
TableName | String | キーを含むテーブルの名前。 |
ColumnName | String | キーカラムの名前 |
PrimaryKeyName | String | 主キーの名前。 |
ForeignKeyName | String | 外部キーの名前。 |
ReferencedCatalogName | String | 主キーを含むデータベース。 |
ReferencedSchemaName | String | 主キーを含むスキーマ。 |
ReferencedTableName | String | 主キーを含むテーブル。 |
ReferencedColumnName | String | 主キーのカラム名。 |
ForeignKeyType | String | 外部キーがインポート(他のテーブルを指す)キーかエクスポート(他のテーブルから参照される)キーかを指定します。 |
主キーについて説明します。
次のクエリは、すべてのテーブルとビューから主キーを取得します。
SELECT * FROM sys_primarykeys
Name | Type | Description |
CatalogName | String | キーを含むデータベースの名前。 |
SchemaName | String | キーを含むスキーマの名前。 |
TableName | String | キーを含むテーブルの名前。 |
ColumnName | String | キーカラムの名前。 |
KeySeq | String | 主キーのシーケンス番号。 |
KeyName | String | 主キーの名前。 |
利用可能なインデックスについて説明します。インデックスをフィルタリングすることで、より高速なクエリ応答時間でセレクティブクエリを記述できます。
次のクエリは、主キーでないすべてのインデックスを取得します。
SELECT * FROM sys_indexes WHERE IsPrimary='false'
Name | Type | Description |
CatalogName | String | インデックスを含むデータベースの名前。 |
SchemaName | String | インデックスを含むスキーマの名前。 |
TableName | String | インデックスを含むテーブルの名前。 |
IndexName | String | インデックス名。 |
ColumnName | String | インデックスに関連付けられたカラムの名前。 |
IsUnique | Boolean | インデックスが固有の場合はTrue。そうでない場合はFalse。 |
IsPrimary | Boolean | インデックスが主キーの場合はTrue。そうでない場合はFalse。 |
Type | Int16 | インデックスタイプに対応する整数値:statistic (0)、clustered (1)、hashed (2)、またはother (3)。 |
SortOrder | String | 並べ替え順序:A が昇順、D が降順。 |
OrdinalPosition | Int16 | インデックスのカラムのシーケンスナンバー。 |
利用可能な接続プロパティと、接続文字列に設定されている接続プロパティに関する情報を返します。
このテーブルをクエリする際は、config 接続文字列を使用する必要があります。
jdbc:cdata:googlesheets:config:
この接続文字列を使用すると、有効な接続がなくてもこのテーブルをクエリできます。
次のクエリは、接続文字列に設定されている、あるいはデフォルト値で設定されているすべての接続プロパティを取得します。
SELECT * FROM sys_connection_props WHERE Value <> ''
Name | Type | Description |
Name | String | 接続プロパティ名。 |
ShortDescription | String | 簡単な説明。 |
Type | String | 接続プロパティのデータ型。 |
Default | String | 明示的に設定されていない場合のデフォルト値。 |
Values | String | 可能な値のカンマ区切りリスト。別な値が指定されていると、検証エラーがスローされます。 |
Value | String | 設定した値またはあらかじめ設定されたデフォルト。 |
Required | Boolean | プロパティが接続に必要かどうか。 |
Category | String | 接続プロパティのカテゴリ。 |
IsSessionProperty | String | プロパティが、現在の接続に関する情報を保存するために使用されるセッションプロパティかどうか。 |
Sensitivity | String | プロパティの機密度。これは、プロパティがロギングおよび認証フォームで難読化されているかどうかを通知します。 |
PropertyName | String | キャメルケースの短縮形の接続プロパティ名。 |
Ordinal | Int32 | パラメータのインデックス。 |
CatOrdinal | Int32 | パラメータカテゴリのインデックス。 |
Hierarchy | String | このプロパティと一緒に設定する必要がある、関連のある依存プロパティを表示します。 |
Visible | Boolean | プロパティが接続UI に表示されるかどうかを通知します。 |
ETC | String | プロパティに関するその他のさまざまな情報。 |
Cloud がデータソースにオフロードできるSELECT クエリ処理について説明します。
SQL 構文の詳細については、SQL 準拠 を参照してください。
以下はSQL 機能のサンプルデータセットです。 SELECT 機能のいくつかの側面がサポートされている場合には、カンマ区切りのリストで返されます。サポートされていない場合、カラムにはNO が入ります。
名前 | 説明 | 有効な値 |
AGGREGATE_FUNCTIONS | サポートされている集計関数。 | AVG, COUNT, MAX, MIN, SUM, DISTINCT |
COUNT | COUNT 関数がサポートされているかどうか。 | YES, NO |
IDENTIFIER_QUOTE_OPEN_CHAR | 識別子をエスケープするための開始文字。 | [ |
IDENTIFIER_QUOTE_CLOSE_CHAR | 識別子をエスケープするための終了文字。 | ] |
SUPPORTED_OPERATORS | サポートされているSQL 演算子。 | =, >, <, >=, <=, <>, !=, LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL, AND, OR |
GROUP_BY | GROUP BY がサポートされているかどうか。サポートされている場合、どのレベルでサポートされているか。 | NO, NO_RELATION, EQUALS_SELECT, SQL_GB_COLLATE |
OJ_CAPABILITIES | サポートされている外部結合の種類。 | NO, LEFT, RIGHT, FULL, INNER, NOT_ORDERED, ALL_COMPARISON_OPS |
OUTER_JOINS | 外部結合がサポートされているかどうか。 | YES, NO |
SUBQUERIES | サブクエリがサポートされているかどうか。サポートされていれば、どのレベルでサポートされているか。 | NO, COMPARISON, EXISTS, IN, CORRELATED_SUBQUERIES, QUANTIFIED |
STRING_FUNCTIONS | サポートされている文字列関数。 | LENGTH, CHAR, LOCATE, REPLACE, SUBSTRING, RTRIM, LTRIM, RIGHT, LEFT, UCASE, SPACE, SOUNDEX, LCASE, CONCAT, ASCII, REPEAT, OCTET, BIT, POSITION, INSERT, TRIM, UPPER, REGEXP, LOWER, DIFFERENCE, CHARACTER, SUBSTR, STR, REVERSE, PLAN, UUIDTOSTR, TRANSLATE, TRAILING, TO, STUFF, STRTOUUID, STRING, SPLIT, SORTKEY, SIMILAR, REPLICATE, PATINDEX, LPAD, LEN, LEADING, KEY, INSTR, INSERTSTR, HTML, GRAPHICAL, CONVERT, COLLATION, CHARINDEX, BYTE |
NUMERIC_FUNCTIONS | サポートされている数値関数。 | ABS, ACOS, ASIN, ATAN, ATAN2, CEILING, COS, COT, EXP, FLOOR, LOG, MOD, SIGN, SIN, SQRT, TAN, PI, RAND, DEGREES, LOG10, POWER, RADIANS, ROUND, TRUNCATE |
TIMEDATE_FUNCTIONS | サポートされている日付および時刻関数。 | NOW, CURDATE, DAYOFMONTH, DAYOFWEEK, DAYOFYEAR, MONTH, QUARTER, WEEK, YEAR, CURTIME, HOUR, MINUTE, SECOND, TIMESTAMPADD, TIMESTAMPDIFF, DAYNAME, MONTHNAME, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, EXTRACT |
REPLICATION_SKIP_TABLES | レプリケーション中にスキップされたテーブルを示します。 | |
REPLICATION_TIMECHECK_COLUMNS | レプリケーション中に更新判断のカラムとして使用するかどうかを、(指定された順に)チェックするカラムのリストを含む文字列の配列。 | |
IDENTIFIER_PATTERN | 識別子としてどの文字列が有効かを示す文字列値。 | |
SUPPORT_TRANSACTION | プロバイダーが、コミットやロールバックなどのトランザクションをサポートしているかどうかを示します。 | YES, NO |
DIALECT | 使用するSQL ダイアレクトを示します。 | |
KEY_PROPERTIES | Uniform データベースを特定するプロパティを示します。 | |
SUPPORTS_MULTIPLE_SCHEMAS | プロバイダー用に複数のスキームが存在するかどうかを示します。 | YES, NO |
SUPPORTS_MULTIPLE_CATALOGS | プロバイダー用に複数のカタログが存在するかどうかを示します。 | YES, NO |
DATASYNCVERSION | このドライバーにアクセスするために必要な、CData Sync のバージョン。 | Standard, Starter, Professional, Enterprise |
DATASYNCCATEGORY | このドライバーのCData Sync カテゴリ。 | Source, Destination, Cloud Destination |
SUPPORTSENHANCEDSQL | API で提供されている以上の、追加SQL 機能がサポートされているかどうか。 | TRUE, FALSE |
SUPPORTS_BATCH_OPERATIONS | バッチ操作がサポートされているかどうか。 | YES, NO |
SQL_CAP | このドライバーでサポートされているすべてのSQL 機能。 | SELECT, INSERT, DELETE, UPDATE, TRANSACTIONS, ORDERBY, OAUTH, ASSIGNEDID, LIMIT, LIKE, BULKINSERT, COUNT, BULKDELETE, BULKUPDATE, GROUPBY, HAVING, AGGS, OFFSET, REPLICATE, COUNTDISTINCT, JOINS, DROP, CREATE, DISTINCT, INNERJOINS, SUBQUERIES, ALTER, MULTIPLESCHEMAS, GROUPBYNORELATION, OUTERJOINS, UNIONALL, UNION, UPSERT, GETDELETED, CROSSJOINS, GROUPBYCOLLATE, MULTIPLECATS, FULLOUTERJOIN, MERGE, JSONEXTRACT, BULKUPSERT, SUM, SUBQUERIESFULL, MIN, MAX, JOINSFULL, XMLEXTRACT, AVG, MULTISTATEMENTS, FOREIGNKEYS, CASE, LEFTJOINS, COMMAJOINS, WITH, LITERALS, RENAME, NESTEDTABLES, EXECUTE, BATCH, BASIC, INDEX |
PREFERRED_CACHE_OPTIONS | 使用したいcacheOptions を指定する文字列値。 | |
ENABLE_EF_ADVANCED_QUERY | ドライバーがEntity Framework の高度なクエリをサポートしているかどうかを示します。サポートしていなければ、クエリはクライアントサイドで処理されます。 | YES, NO |
PSEUDO_COLUMNS | 利用可能な疑似カラムを示す文字列の配列。 | |
MERGE_ALWAYS | 値がtrue であれば、CData Sync 内でMerge Model が強制的に実行されます。 | TRUE, FALSE |
REPLICATION_MIN_DATE_QUERY | レプリケート開始日時を返すSELECT クエリ。 | |
REPLICATION_MIN_FUNCTION | サーバーサイドでmin を実行するために使用する式名を、プロバイダーが指定できるようになります。 | |
REPLICATION_START_DATE | レプリケート開始日を、プロバイダーが指定できるようになります。 | |
REPLICATION_MAX_DATE_QUERY | レプリケート終了日時を返すSELECT クエリ。 | |
REPLICATION_MAX_FUNCTION | サーバーサイドでmax を実行するために使用する式名を、プロバイダーが指定できるようになります。 | |
IGNORE_INTERVALS_ON_INITIAL_REPLICATE | 初回のレプリケートで、レプリケートをチャンクに分割しないテーブルのリスト。 | |
CHECKCACHE_USE_PARENTID | CheckCache 構文を親キーカラムに対して実行するかどうかを示します。 | TRUE, FALSE |
CREATE_SCHEMA_PROCEDURES | スキーマファイルの生成に使用できる、ストアドプロシージャを示します。 |
次のクエリは、WHERE 句で使用できる演算子を取得します。
SELECT * FROM sys_sqlinfo WHERE Name = 'SUPPORTED_OPERATORS'
WHERE 句では、個々のテーブルの制限や要件が異なる場合がありますので注意してください。詳しくは、Spreadsheets のテーブルとしての使用 セクションを参照してください。
Name | Type | Description |
NAME | String | SQL 構文のコンポーネント、またはサーバー上で処理できる機能。 |
VALUE | String | サポートされるSQL またはSQL 構文の詳細。 |
試行された変更に関する情報を返します。
次のクエリは、バッチ処理で変更された行のId を取得します。
SELECT * FROM sys_identity
Name | Type | Description |
Id | String | データ変更処理から返された、データベース生成Id。 |
Batch | String | バッチの識別子。1 は単一処理。 |
Operation | String | バッチ内の処理の結果:INSERTED、UPDATED、またはDELETED。 |
Message | String | SUCCESS、またはバッチ内の更新が失敗した場合のエラーメッセージ。 |
プロパティ | 説明 |
AuthScheme | Google Sheets に接続する際に使用する認証の種類。 |
APIKey | クライアントアプリケーションでOAuth 2.0を使用していない場合は、Google Cloud Platform プロジェクト内で有効になっているAPI を呼び出すときにAPI キーを含める必要があります。 |
プロパティ | 説明 |
Spreadsheet | 参照されるスプレッドシートの名前もしくはId のカンマ区切りのリスト。 |
FolderName | FolderName='name1,name2' の形式でスプレッドシートを取得するフォルダの名前のカンマ区切りリスト。 |
FolderId | FolderId='id1,id2,id3' の形式でスプレッドシートを取得するフォルダのId のカンマ区切りリスト。 |
ShowTrashedFiles | ごみ箱の中のファイルをリストするかどうかを示します。 |
SkipHiddenSheets | 非表示のシートをリストするかどうかを示します。 |
SupportsAllDrives | ドライブのアイテムを取得するかどうかを決定します。 |
UseIdAsTableName | Id をスプレッドシート名およびシート名として使用するかどうかを指定します。 |
TeamDrive | TeamDrive='Shared drive 2, Shared drive 3'、またはTeamDrive='0BKwyFj1j9FOsUk9EVO, 0ANMIP9RIe1LQUk9PVA' の形式でスプレッドシートを取得するドライブの名前またはID。 |
DomainSharedFilesOnly | 公開されるシートがユーザーのドメインに共有されるシートのみに限定されるかどうかを決定するboolean。 |
RecurseFolders | FolderId / FolderName プロパティが定義されている場合に使用します。True に設定すると、ドライバーはネストされたフォルダ内のすべてのスプレッドシートを返し、そうでなければ、ドライバーはフォルダの直下のファイルのみを返します。デフォルトではfalse に設定されています。 |
IgnoreErrorValues | 有効にすると、provider がエラー値を検出したフィールドはNULL として返されます。無効の場合、provider はいずれかのフィールドでエラー値が検出されるとエラーをスローします。 |
プロパティ | 説明 |
OAuthJWTCert | JWT 証明書のストア。 |
OAuthJWTCertType | JWT 証明書を格納するキーストアの種類。 |
OAuthJWTCertPassword | OAuth JWT 証明書のパスワード。 |
OAuthJWTCertSubject | OAuth JWT 証明書のサブジェクト。 |
OAuthJWTIssuer | Java Web Token の発行者。 |
OAuthJWTSubject | アプリケーションからデリゲートアクセスの要求対象となるユーザーサブジェクト。 |
プロパティ | 説明 |
SSLServerCert | TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。 |
プロパティ | 説明 |
Verbosity | ログファイルの記述をどの程度の詳細さで記載するかを決定するverbosity レベル。 |
プロパティ | 説明 |
BrowsableSchemas | このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。 |
TypeDetectionScheme | カラムのデータ型を決定するための方法を指定します。 |
Header | 最初の行を列ヘッダーとして使用するかどうかを示します。 |
PrimaryKeyIdentifier | 主キーの名前を制御するには、このプロパティを設定します。 |
DefineTables | Google スプレッドシート内でテーブルを定義 |
Orientation | シート内のデータを水平方向に配置するか、垂直方向に配置するかを示します。 |
プロパティ | 説明 |
AutoAdjustRange | True に設定すると、更新/挿入/削除された値がシートの範囲外にある場合、ドライバーは自動的にディメンションを拡張します。 |
DateTimeRenderOption | 日付、時間および期間がアウトプットで表されるかを定義します。 ValueRenderOption がFormattedValue の場合には、これは無視されます。デフォルトのdatetime レンダリングオプションはSerialNumber です。 |
InsertDataOption | 新しいデータがインプットされた際に、既存のデータがどのように変更されるかを決めます。 |
MaxRows | クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。 |
NullValueMode | 空のセルをnull として読み取るか、空として読み取るかを示します。 |
Pagesize | Google Sheets から返されるページあたりの結果の最大数。 |
PercentageToDecimal | パーセンテージの列をdecimal 表示するかどうかを決定するboolean。 |
PseudoColumns | このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。 |
RowScanDepth | テーブルで利用可能なカラムを探すためにスキャンする行数の最大値。 |
ShowEmptyRows | 空の行をプッシュするかどうかを示します。 |
Timeout | タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。 |
UseSimpleNames | テーブルとカラムに簡略名を使用するかどうかを決定するboolean。 |
ValueInputOption | 挿入された値をどのように扱うべきかを定義します。 |
ValueRenderOption | アウトプットで値がどのようにレンダリングされるかを定義します。 |
このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。
プロパティ | 説明 |
AuthScheme | Google Sheets に接続する際に使用する認証の種類。 |
APIKey | クライアントアプリケーションでOAuth 2.0を使用していない場合は、Google Cloud Platform プロジェクト内で有効になっているAPI を呼び出すときにAPI キーを含める必要があります。 |
Google Sheets に接続する際に使用する認証の種類。
string
"OAuth"
クライアントアプリケーションでOAuth 2.0を使用していない場合は、Google Cloud Platform プロジェクト内で有効になっているAPI を呼び出すときにAPI キーを含める必要があります。
string
""
クライアントアプリケーションでOAuth 2.0を使用していない場合は、Google Cloud Platform プロジェクト内で有効になっているAPI を呼び出すときにAPI キーを含める必要があります。
このセクションでは、本プロバイダーの接続文字列で設定可能なConnection プロパティの全リストを提供します。
プロパティ | 説明 |
Spreadsheet | 参照されるスプレッドシートの名前もしくはId のカンマ区切りのリスト。 |
FolderName | FolderName='name1,name2' の形式でスプレッドシートを取得するフォルダの名前のカンマ区切りリスト。 |
FolderId | FolderId='id1,id2,id3' の形式でスプレッドシートを取得するフォルダのId のカンマ区切りリスト。 |
ShowTrashedFiles | ごみ箱の中のファイルをリストするかどうかを示します。 |
SkipHiddenSheets | 非表示のシートをリストするかどうかを示します。 |
SupportsAllDrives | ドライブのアイテムを取得するかどうかを決定します。 |
UseIdAsTableName | Id をスプレッドシート名およびシート名として使用するかどうかを指定します。 |
TeamDrive | TeamDrive='Shared drive 2, Shared drive 3'、またはTeamDrive='0BKwyFj1j9FOsUk9EVO, 0ANMIP9RIe1LQUk9PVA' の形式でスプレッドシートを取得するドライブの名前またはID。 |
DomainSharedFilesOnly | 公開されるシートがユーザーのドメインに共有されるシートのみに限定されるかどうかを決定するboolean。 |
RecurseFolders | FolderId / FolderName プロパティが定義されている場合に使用します。True に設定すると、ドライバーはネストされたフォルダ内のすべてのスプレッドシートを返し、そうでなければ、ドライバーはフォルダの直下のファイルのみを返します。デフォルトではfalse に設定されています。 |
IgnoreErrorValues | 有効にすると、provider がエラー値を検出したフィールドはNULL として返されます。無効の場合、provider はいずれかのフィールドでエラー値が検出されるとエラーをスローします。 |
参照されるスプレッドシートの名前もしくはId のカンマ区切りのリスト。
string
""
参照されるスプレッドシートの名前もしくはId のカンマ区切りのリスト。このデータを取得するには、Spreadsheets ビューをクエリします。
Note:スプレッドシートの名前を入力する際、先頭や末尾のスペースを含めて正確なスプレッドシート名を入力してください。 また、カンマの区切りの前後に余分なスペースを加えてないようにします。スプレッドシート名にカンマが含まれる場合は、バックスラッシュ'\' でエスケープしてください。
FolderName='name1,name2' の形式でスプレッドシートを取得するフォルダの名前のカンマ区切りリスト。
string
""
FolderName='name1,name2' の形式でスプレッドシートを取得するフォルダの名前のカンマ区切りリスト。
FolderId='id1,id2,id3' の形式でスプレッドシートを取得するフォルダのId のカンマ区切りリスト。
string
""
FolderId='id1,id2,id3' の形式でスプレッドシートを取得するフォルダのId のカンマ区切りリスト。
ごみ箱の中のファイルをリストするかどうかを示します。
bool
false
True の場合、ドライバーはごみ箱に置かれたファイル/スプレッドシートをリストします。
非表示のシートをリストするかどうかを示します。
bool
false
true の場合、ドライバーは非表示のシートをスキップします。
ドライブのアイテムを取得するかどうかを決定します。
bool
false
このプロパティを'true' に設定すると、任意のドライブスプレッドシートからクエリを実行できます。
Id をスプレッドシート名およびシート名として使用するかどうかを指定します。
bool
false
Id をスプレッドシート名およびシート名として使用するかどうかを指定します。 SpreadsheetName_SheetName の代わりにシートで選択するには、次のようにします:SpreadsheetId_SheetId。例:SELECT * FROM 11696gdF5QUL1EnYikYiUeMTHRqA1111KbdYDoINqI_1151117664
TeamDrive='Shared drive 2, Shared drive 3'、またはTeamDrive='0BKwyFj1j9FOsUk9EVO, 0ANMIP9RIe1LQUk9PVA' の形式でスプレッドシートを取得するドライブの名前またはID。
string
""
TeamDrive='Shared drive 2, Shared drive 3'、またはTeamDrive='0BKwyFj1j9FOsUk9EVO, 0ANMIP9RIe1LQUk9PVA' の形式でスプレッドシートを取得するドライブの名前またはID。
FolderId / FolderName プロパティが定義されている場合に使用します。True に設定すると、ドライバーはネストされたフォルダ内のすべてのスプレッドシートを返し、そうでなければ、ドライバーはフォルダの直下のファイルのみを返します。デフォルトではfalse に設定されています。
bool
false
FolderId / FolderName プロパティが定義されている場合に使用します。True に設定すると、ドライバーはネストされたフォルダ内のすべてのスプレッドシートを返し、そうでなければ、ドライバーはフォルダの直下のファイルのみを返します。デフォルトではfalse に設定されています。
有効にすると、provider がエラー値を検出したフィールドはNULL として返されます。無効の場合、provider はいずれかのフィールドでエラー値が検出されるとエラーをスローします。
bool
true
このプロパティがtrue に設定されている場合、Cloud は値にエラーを含むフィールドをNULL として返します。
このプロパティがfalse に設定されている場合には、値にエラーが見つかった場合にCloud はエラーをスローします。
Cloud は以下のエラー値を確認します。
このセクションでは、本プロバイダーの接続文字列で設定可能なJWT OAuth プロパティの全リストを提供します。
プロパティ | 説明 |
OAuthJWTCert | JWT 証明書のストア。 |
OAuthJWTCertType | JWT 証明書を格納するキーストアの種類。 |
OAuthJWTCertPassword | OAuth JWT 証明書のパスワード。 |
OAuthJWTCertSubject | OAuth JWT 証明書のサブジェクト。 |
OAuthJWTIssuer | Java Web Token の発行者。 |
OAuthJWTSubject | アプリケーションからデリゲートアクセスの要求対象となるユーザーサブジェクト。 |
JWT 証明書のストア。
string
""
クライアント証明書のための証明書ストア名。
OAuthJWTCertType フィールドは、OAuthJWTCert により指定された証明書ストアの種類を指定します。 ストアがパスワードで保護されている場合は、OAuthJWTCertPassword でパスワードを指定します。
OAuthJWTCert は、OAuthJWTCertSubject フィールドとともにクライアント証明書を指定するために使われます。 OAuthJWTCert に値がある場合で、OAuthJWTCertSubject が設定されている場合は、証明書の検索が始まります。 詳しくは、OAuthJWTCertSubject フィールドを参照してください。
証明書ストアの指定はプラットフォームに依存します。
Windows の共通のユーザとシステム証明書ストアの指定は以下のとおりです。
MY | 個人証明書と関連付けられた秘密キーを格納している証明書ストア。 |
CA | 証明機関の証明書。 |
ROOT | ルート証明書。 |
SPC | ソフトウェア発行元証明書。 |
Javaでは、証明書ストアは通常、証明書および任意の秘密キーを含むファイルです。
証明書ストアの種類がPFXFile の場合は、このプロパティにファイル名を設定します。 PFXBlob の場合は、このプロパティをPFX ファイルのバイナリコンテンツ(例えば、PKCS12証明書ストア)に設定する必要があります。
JWT 証明書を格納するキーストアの種類。
string
"GOOGLEJSONBLOB"
このプロパティには次の値の一つを設定できます。
USER | Windows の場合、現在のユーザーにより所有された証明書ストアであることを指定します。 Note:この種類はJava では利用できません。 |
MACHINE | Windows の場合、この証明書ストアがシステムストアであることを指定します。 Note:この種類はJava では利用できません。 |
PFXFILE | この証明書ストアは、証明書を含むPFX(PKCS12)ファイルの名前です。 |
PFXBLOB | この証明書ストアは、PFX(PKCS12)形式の証明書ストアを表すBase-64でエンコードされた文字列です。 |
JKSFILE | この証明書ストアは、証明書を含むJava key store(JKS)ファイルの名前です。 Note:この種類はJava のみで利用できます。 |
JKSBLOB | この証明書ストアは、Java key store(JKS)形式の証明書ストアを表すBase-64でエンコードされた文字列です。 Note:この種類はJava のみで利用できます。 |
PEMKEY_FILE | この証明書ストアは、秘密キーと任意の証明書を含むPEM でエンコードされたファイルの名前です。 |
PEMKEY_BLOB | この証明書ストアは、秘密キーと任意の証明書を含むBase-64でエンコードされた文字列です。 |
PUBLIC_KEY_FILE | この証明書ストアは、PEM またはDER でエンコードされた公開キーの証明書を含むファイルの名前です。 |
PUBLIC_KEY_BLOB | この証明書ストアは、PEM またはDER でエンコードされた公開キーの証明書を含むBase-64でエンコードされた文字列です。 |
SSHPUBLIC_KEY_FILE | この証明書ストアは、SSH 公開キーを含むファイルの名前です。 |
SSHPUBLIC_KEY_BLOB | この証明書ストアは、SSH 公開キーを含むBase-64でエンコードされた文字列です。 |
P7BFILE | この証明書ストアは、証明書を含むPKCS7 ファイルの名前です。 |
PPKFILE | この証明書ストアは、PuTTY 秘密キー(PPK)を含むファイルの名前です。 |
XMLFILE | この証明書ストアは、XML 形式の証明書を含むファイルの名前です。 |
XMLBLOB | この証明書ストアは、XML 形式の証明書を含む文字列の名前です。 |
GOOGLEJSON | この証明書ストアは、サービスアカウント情報を含むJSON ファイルの名前です。Google サービスに接続する場合にのみ有効です。 |
GOOGLEJSONBLOB | この証明書ストアは、サービスアカウントのJSON を含む文字列です。Google サービスに接続する場合にのみ有効です。 |
OAuth JWT 証明書のパスワード。
string
""
証明書ストアでパスワードが必要である場合、このプロパティを使用してパスワードを指定し、証明書ストアにアクセスできます。
GOOGLEJSON OAuthJWTCertType を使用する場合は必要ありません。Google JSON キーは暗号化されていません。
OAuth JWT 証明書のサブジェクト。
string
"*"
証明書のサブジェクトは、証明書をロードするときにストア内の証明書を検索するために使用されます。
完全に一致するものが見つからない場合、ストアはプロパティの値を含むサブジェクトを検索します。
それでも一致するものが見つからない場合、プロパティは空白で設定され、証明書は選択されません。
"*" に設定すると、証明書ストアの1番目の証明書が選択されます。
証明書のサブジェクトは識別の名前フィールドおよび値のカンマ区切りのリストです。 例えば、"CN=www.server.com, OU=test, C=US, [email protected]"。共通のフィールドとその説明は以下のとおりです。
フィールド | 説明 |
CN | 共通名。一般的には、www.server.com のようなホスト名です。 |
O | 法人名 |
OU | 法人の部署名 |
L | 法人の住所(市町村名) |
S | 法人の住所(都道府県) |
C | 国名 |
E | Eメールアドレス |
フィールド値にカンマが含まれている場合は、それを引用符で囲む必要があります。
Java Web Token の発行者。
string
""
Java Web Token の発行者。 委任されたユーザーのE メールアドレスの値を入力します。
GOOGLEJSON OAuthJWTCertType を使用する場合は必要ありません。Google JSON キーには、発行者アカウントのコピーが含まれています。
Java Web Token の発行者。 委任されたユーザーのE メールアドレスの値を入力します。
GOOGLEJSON OAuthJWTCertType を使用する場合は必要ありません。Google JSON キーには、発行者アカウントのコピーが含まれています。
アプリケーションからデリゲートアクセスの要求対象となるユーザーサブジェクト。
string
""
アプリケーションからデリゲートアクセスの要求対象となるユーザーサブジェクトです。 サービスアカウントE メールの値を入力します。
アプリケーションからデリゲートアクセスの要求対象となるユーザーサブジェクトです。 サービスアカウントE メールの値を入力します。
このセクションでは、本プロバイダーの接続文字列で設定可能なSSL プロパティの全リストを提供します。
プロパティ | 説明 |
SSLServerCert | TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。 |
TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。
string
""
TLS/SSL 接続を使用する場合は、このプロパティを使用して、サーバーが受け入れるTLS/SSL 証明書を指定できます。コンピュータによって信頼されていない他の証明書はすべて拒否されます。
このプロパティは、次のフォームを取ります:
説明 | 例 |
フルPEM 証明書(例では省略されています) | -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE----- |
証明書を保有するローカルファイルへのパス。 | C:\cert.cer |
公開鍵(例では省略されています) | -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY----- |
MD5 Thumbprint (hex 値はスペースおよびコロン区切り) | ecadbdda5a1529c58a1e9e09828d70e4 |
SHA1 Thumbprint (hex 値はスペースおよびコロン区切り) | 34a929226ae0819f2ec14b4a3d904f801cbb150d |
これを指定しない場合は、マシンが信用するすべての証明書が受け入れられます。
すべての証明書の受け入れを示すには、'*'を使用します。セキュリティ上の理由から、これはお勧めできません。
このセクションでは、本プロバイダーの接続文字列で設定可能なLogging プロパティの全リストを提供します。
プロパティ | 説明 |
Verbosity | ログファイルの記述をどの程度の詳細さで記載するかを決定するverbosity レベル。 |
このセクションでは、本プロバイダーの接続文字列で設定可能なSchema プロパティの全リストを提供します。
プロパティ | 説明 |
BrowsableSchemas | このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。 |
TypeDetectionScheme | カラムのデータ型を決定するための方法を指定します。 |
Header | 最初の行を列ヘッダーとして使用するかどうかを示します。 |
PrimaryKeyIdentifier | 主キーの名前を制御するには、このプロパティを設定します。 |
DefineTables | Google スプレッドシート内でテーブルを定義 |
Orientation | シート内のデータを水平方向に配置するか、垂直方向に配置するかを示します。 |
このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
string
""
スキーマをデータベースからリストすると、負荷がかかる可能性があります。接続文字列でスキーマのリストを提供すると、 パフォーマンスが向上します。
カラムのデータ型を決定するための方法を指定します。
string
"RowScan"
None | TypeDetectionScheme をNone に設定した場合は、すべてのカラムは文字列型で返されます。 Note:None に設定した場合でも、Header がTrue に設定されている場合は、カラム名は引き続きスキャンされます。 |
RowScan | TypeDetectionScheme をRowScan に設定した場合は、ヒューリスティックにデータ型を決定します。RowScanDepth ではスキャンする行数を決定します。これを-1に設定すると、ドライバーはシート全体をスキャンします。 |
最初の行を列ヘッダーとして使用するかどうかを示します。
bool
true
true の場合は、最初の行が列ヘッダーとして使用されます。そうでない場合は、疑似列名(A、B、C など)が使用されます。
Header プロパティはOrientation プロパティと一緒に使用します。Header がfalse、Orientation がColumns に設定されている場合、列名はR1、R2、R3、etc. のようにレポートされます。
主キーの名前を制御するには、このプロパティを設定します。
string
""
行番号を持つ主キーカラムの名前を決定します。主キーのデフォルト値はId です。
クエリ対象のテーブルにID という名前のカラムがある場合、または主キーの名前を変更したい場合は、このプロパティを設定します。
Google スプレッドシート内でテーブルを定義
string
""
このプロパティを使って、テーブルとして表示するシートの範囲を定義します。値は、名前と値のペアのカンマ区切りリストで、[Table Name]=[Spreadsheet Name]_[Sheet Name]![Range] または[Table Name]=[Spreadsheet Name]_[Sheet Name]![Range] の形式になります。 Table Name はデータに使うテーブルの名前で、クエリを発行する際に使用されます。 Sheet Name はGoogle スプレッドシート内にあるシートの名前で、Range はテーブルのデータを含むセルの範囲です。
DefineTables 値の例を示します。DefineTables="Table1=Spreadsheet1_Sheet1!A1:N25,Table2=Spreadsheet1_Sheet2!C3:M53,Table4=xIsPcLs2-bF3AavQcSLCfzs3kGc_Sheet4!C20:N60"
シート内のデータを水平方向に配置するか、垂直方向に配置するかを示します。
string
"Vertical"
Horizontal | Cloud がシートの行に操作することを指定します。 |
Vertical | Cloud がシートの列に操作することを指定します。 |
行が左から右に配置されている場合は、これを"Horizontal" に設定します。最初の列は列名を含み、後続の列は行になります。
このセクションでは、本プロバイダーの接続文字列で設定可能なMiscellaneous プロパティの全リストを提供します。
プロパティ | 説明 |
AutoAdjustRange | True に設定すると、更新/挿入/削除された値がシートの範囲外にある場合、ドライバーは自動的にディメンションを拡張します。 |
DateTimeRenderOption | 日付、時間および期間がアウトプットで表されるかを定義します。 ValueRenderOption がFormattedValue の場合には、これは無視されます。デフォルトのdatetime レンダリングオプションはSerialNumber です。 |
InsertDataOption | 新しいデータがインプットされた際に、既存のデータがどのように変更されるかを決めます。 |
MaxRows | クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。 |
NullValueMode | 空のセルをnull として読み取るか、空として読み取るかを示します。 |
Pagesize | Google Sheets から返されるページあたりの結果の最大数。 |
PercentageToDecimal | パーセンテージの列をdecimal 表示するかどうかを決定するboolean。 |
PseudoColumns | このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。 |
RowScanDepth | テーブルで利用可能なカラムを探すためにスキャンする行数の最大値。 |
ShowEmptyRows | 空の行をプッシュするかどうかを示します。 |
Timeout | タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。 |
UseSimpleNames | テーブルとカラムに簡略名を使用するかどうかを決定するboolean。 |
ValueInputOption | 挿入された値をどのように扱うべきかを定義します。 |
ValueRenderOption | アウトプットで値がどのようにレンダリングされるかを定義します。 |
True に設定すると、更新/挿入/削除された値がシートの範囲外にある場合、ドライバーは自動的にディメンションを拡張します。
bool
false
True に設定すると、更新/挿入/削除された値がシートの範囲外にある場合、ドライバーは自動的にディメンションを拡張します。
日付、時間および期間がアウトプットで表されるかを定義します。 ValueRenderOption がFormattedValue の場合には、これは無視されます。デフォルトのdatetime レンダリングオプションはSerialNumber です。
string
"SerialNumber"
SerialNumber | 日付、時間、datetime および期間のフィールドが、Lotus 1-2-3 のように"serial number" 形式のダブルで表示されるようCloud に指示します。値の整数部分(ピリオドの左側)は1899年12月30日からの日にちをカウントしています。小数部分(ピリオドの右側)は、時間を日の少数で表します。例えば、1900年1月1日の昼の12時は、2.5 と表示されます。これは1899年12月30日から2日後で、昼の12時は1日の半分なので0.5 となります。1900年2月1日の午後3時は、33.625 です。これは1900年を飛ばしません。 |
FormattedString | 日付、時間、datetime および期間のフィールドが、数字形式の文字列としてアウトプットされるようCloud に指示します。これはスプレッドシートのロケールとは関係がありません。 |
新しいデータがインプットされた際に、既存のデータがどのように変更されるかを決めます。
string
"Overwrite"
Overwrite |
新しいデータは、テーブルの最後の行の次の行の内容を置き換えます。テーブルの最終行の後にデータが上書きされる可能性があることに注意してください。これは、Cloud は空の行を見つけると行を返すことをやめるためです。 Cloud が スプレッドシートデータからテーブルを検出する方法について、詳しくはテーブル を参照してください。 |
InsertRows | Cloud は、指定された行(またはテーブルの最後)に新しい行を挿入します。これは、下のすべての行のId を1ずつインクリメントすることで、テーブルの下のデータを上書きするのを防ぎます。また、既存の行の間にデータを挿入することもできます。次のクエリは新しい行2を挿入します。既存の行2は行3になり、行3は行4になります。
INSERT INTO Spreadsheet1_Sheet1(Id,Name, Amount) VALUES (2,'Test', 10) |
クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。
int
-1
クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。
空のセルをnull として読み取るか、空として読み取るかを示します。
string
"ReadAsNull"
NullValueMode は、空のGoogle Sheets セルをどのようにモデル化するかを制御します。空のセルは、設定されていないセル(null 文字列が含まれているセル)です。NullValueMode をReadAsNull に設定すると、空のセルに対してNULL が報告されます。NullValueMode をReadAsEmpty に設定すると、空のセルに対して空の文字列が報告されます。
Google Sheets から返されるページあたりの結果の最大数。
int
1000
Pagesize プロパティは、Google Sheets から返されるページあたりの結果の最大数に影響を与えます。より大きい値を設定すると、1ページあたりの消費メモリが増える代わりに、パフォーマンスが向上する場合があります。
パーセンテージの列をdecimal 表示するかどうかを決定するboolean。
bool
false
パーセンテージの列をdecimal 表示するかどうかを決定するboolean。
このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。
string
""
Entity Framework ではテーブルカラムでない疑似カラムに値を設定できないため、この設定はEntity Framework で特に便利です。この接続設定の値は、"Table1=Column1, Table1=Column2, Table2=Column3" の形式です。"*=*" のように"*" 文字を使用して、すべてのテーブルとすべてのカラムを含めることができます。
テーブルで利用可能なカラムを探すためにスキャンする行数の最大値。
int
50
テーブルのカラムはテーブル行をスキャンすることで決定される必要があります。この値はスキャンされる行数の最大値を設定します。
大きい値を設定すると、パフォーマンスが低下する場合があります。小さい値を設定すると、特にnull データがある場合には、データ型を正しく判定できない場合があります。
空の行をプッシュするかどうかを示します。
bool
false
true の場合、空の行が出力時にプッシュされます。
タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
int
60
Timeout が0に設定されている場合は、操作がタイムアウトしません。処理が正常に完了するか、エラー状態になるまで実行されます。
Timeout の有効期限が切れても処理が完了していない場合は、Cloud は例外をスローします。
テーブルとカラムに簡略名を使用するかどうかを決定するboolean。
bool
false
Google Sheets テーブルおよびカラムでは、 通常のデータベースでは使うことが認められていない特殊記号・文字を名前に使うことができます。UseSimpleNames を使用すると、Cloud を従来のデータベースツールでより簡単に使用できるようになります。
UseSimpleNames をtrue に設定し、返されるテーブル名およびカラム名をシンプルにします。表示されるテーブル名 およびカラム名においてアルファベット文字およびアンダースコアのみを有効とするネーミングスキームを強制します。 英数字以外の文字はすべて、アンダースコアに変換されます。
挿入された値をどのように扱うべきかを定義します。
string
"UserEntered"
Raw | ユーザーが入力した値はパースされず、as-is で保存されます。 |
UserEntered | ユーザーがUI にタイプしたのと同じように、値はパースされます。数値は数値のままですが、文字列は、Google シートUI に入力する際と同じルールで数値、日付などに変更されます。 |
アウトプットで値がどのようにレンダリングされるかを定義します。
string
"FormattedValue"
FormattedValue | セルの形式に基づいて、値が計算およびフォーマットされます。形式はリクエストしているユーザーのロケールではなく、スプレッドシートのロケールによってなされます。例えば、A1 が"1.23" でA2 が"=A1" で、形式が通貨の場合、A2 は"$1.23" となります。 |
UnformattedValue | 戻り値で、値は計算されますが、フォーマットされません。例えば、A1 が"1.23" でA2 が"=A1" で、形式が通貨の場合、A2 は"1.23" という数値を返します。 |
Formula | 値は計算されません。戻り値は数式を含みます。例えば、A1 が"1.23" でA2 が"=A1" で、形式が通貨の場合、A2 は"=A1" となります。 |