現状ではGoogle スプレッドシートアダプターをご利用する際には下記のような注意事項があります。
なお、この記事は「Excel / Google Sheetsアダプター」(ASTERIA Warp 2512以降で利用可能なオプション製品)に関するものではありません。
■共通
マルチセレクトオプション(旧 CDataオプション)の利用上の共通的な注意事項については下記をご参照ください。
■動作環境
- ASTERIA Warp 1610以降
■アダプターの動作
- GoogleSheetsGet
- レコード取得時にソートができないテーブルがあります。
例)Spreadsheetsなど - 追加したシートがSQLビルダー画面で表示されない場合は以下の通り、該当コネクションのスキーマ情報のキャッシュをリセットすることで表示されます。
- 新規フローを作成してGoogleSheetsSQLCallコンポーネントを配置し、以下の通りプロパティ設定を行う
- コネクション名:既存のコネクション
- 実行する処理:「任意のSQLを実行」
- SQL文:「RESET SCHEMA CACHE」
- フローを実行する
- 新規フローを作成してGoogleSheetsSQLCallコンポーネントを配置し、以下の通りプロパティ設定を行う
- レコード取得時にソートができないテーブルがあります。
■更新履歴
- ASTERIA Warp 2608
- TLS 1.3 がHTTP 接続のデフォルトでサポートされるようになりました。
- NullValueMode 接続プロパティにReadAsEmptyOrNull 列挙値が追加されました。
この値は、文字列列には空文字列を、その他のデータ型にはNULL 値を返します。 - IncludePrimaryKey 接続プロパティが追加されました。
- AddSheet ストアドプロシージャに、カンマ区切りリストとして提供される新しい入力パラメータHeaderNames のサポートが追加されました。HeaderNames は、新しいシートの最初の行として追加されるカラムヘッダーの名前を提供します。
これらのヘッダーは、後でデータの挿入や更新に使用できます。 - CreateSpreadsheet ストアドプロシージャにHeaderNames 入力パラメータが追加されました。
- 以前は、同名のフォルダ配下に同じファイル名の2つのスプレッドシートが存在し、ユーザーがUseIdAsTableName プロパティを有効化していた場合、ドライバーは最新の変更があるファイルのみを選択し、もう一方のファイルは無視していました。現在は、重複する名前を持つテーブル(<spreadsheetName>_<spreadsheetId> の形式)の名前には<index> マーカーが末尾に追加され、UseIdAsTableName がすべての該当ファイルを返すようになりました。
- ASTERIA Warp 2512
- Folders テーブルからChildIds およびChildLinks カラムが削除されました。
- Scope 接続プロパティが追加されました。
- ASTERIA Warp 2506
- 大きな変更点はありません。
- ASTERIA Warp 2412
- デフォルトの認証スキームがOAuthに変更されました。
- 認証スキーム Auto は削除されました。認証スキーム Auto を利用していた場合は、そのままフローを実行するとエラーが発生しますので設定変更が必要です。
- IncludeValuesInResponse 接続プロパティは削除されました。
- ASTERIA Warp 2406
- 大きな変更点はありません。
- ASTERIA Warp 2312
- コネクションのプロパティ Recurse Folders が選択式に変更されました。デフォルト値は「いいえ」です。
- コネクションの下記のプロパティが名称変更されました。
TeamDriveSupport → SupportsAllDrives - コネクションにプロパティ SkipHiddenSheets が追加されました。
- 下記のカラムが名称変更されました。
TeamDriveId → DriveId
- ASTERIA Warp 2306
- GoogleスプレッドシートのAPIからHTTP 429 (API Limit Exceeded)が返されたとき、コンポーネント側ではToo many requestsのエラーメッセージを出力するよう修正されました。
- 接続プロパティIgnoreErrorValuesが追加されました。デフォルトでは、エラー値を持つセルはスキップされます。接続プロパティをtrueに設定すると、エラー値がある場合、コンポーネントは例外をスローするようになります。
- 下記のストアドプロシージャが追加されました。
AddDatasource, AddDatasourceTable - SpreadsheetsテーブルからHiddenカラムが削除されました。
- SheetsテーブルにHiddenカラムが追加されました。
- ASTERIA Warp 2212
- コネクションにRecurseFoldersプロパティが追加されました。
- FolderNameプロパティやFolderIdプロパティが定義されている場合
RecurseFoldersプロパティにtrueを指定すると、定義されたフォルダ配下のスプレッドシートの一覧がサブフォルダ内を含めて取得されるようになりました。
RecurseFoldersプロパティにfalseを指定すると、定義されたフォルダ直下だけのスプレッドシートの一覧が取得されます(従来通りの動作)。 - FolderNameプロパティやFolderIdプロパティが定義されていない場合
RecurseFoldersプロパティの定義にかかわらず、アクセス可能なスプレッドシートの一覧がすべて取得されます(従来通りの動作)。
- FolderNameプロパティやFolderIdプロパティが定義されている場合
- Select、Insert、Update操作において、カスタムレンジを使用する場合の仕様が一部変更され、カラム名が範囲に基づいて適切に命名されるようになりました。これは、Header connection プロパティが false に設定されている場合にのみ有効です。
- 例えば SELECT * FROM Spreadsheet_Sheet1#C1:F5 というクエリを実行する場合、以前はカラム名がA,B,C,Dとなりましたが、今後はC,D,E,Fとなります。
- コネクションにRecurseFoldersプロパティが追加されました。
- ASTERIA Warp 2112
- 下記のビューが追加されました。
- Folders
- 下記のシステムテーブルが追加されました。
- sys_foreignkeys
- 他の変更履歴は下記でご確認ください。
https://cdn.cdata.com/help/RLG/jp/jdbc/pg_changelog.htm
- 下記のビューが追加されました。
- ASTERIA Warp 2106
- GoogleSheetsSQLCallコンポーネントでストアドプロシージャの処理が正しく動作しない不具合を修正しました。
- ASTERIA Warp 2012
- コネクションプロパティ「DeleteRowOrColumn」が廃止されました。
Delete処理では行削除となります。
以前作成したコネクションで上記のプロパティを指定していた場合は削除してください。
- コネクションプロパティ「DeleteRowOrColumn」が廃止されました。
上記は現在、弊社で確認した内容について記載しています。
今後、不具合対応やバージョンアップなどで改善される場合は確認出来次第、反映します。
他にマルチセレクトオプション固有の制限事項について詳しくは以下のヘルプをご参考ください。
| ASTERIA Warpバージョン | ヘルプページ |
| 2608 | https://cdn.cdata.com/help/RLN/jp/jdbc/ |
| 2512 | https://cdn.cdata.com/help/RLM/jp/jdbc/ |
| 2506 | https://cdn.cdata.com/help/RLK/jp/jdbc/ |
| 2412 | |
| 2406 | https://cdn.cdata.com/help/RLJ/jp/jdbc/ |
| 2312 | |
| 2306 | https://cdn.cdata.com/help/RLH/jp/jdbc/ |
| 2212 | https://cdn.cdata.com/help/RLG/jp/jdbc/ |
| 2206 | |
| 2112 | |
| 2106 | http://cdn.cdata.com/help/RLF/jp/jdbc/ |
| 2012 | |
| 1912 | http://cdn.cdata.com/help/RLE/jp/jdbc/ |
| 1906 | |
| 1812 | http://cdn.cdata.com/help/GLD/jdbc/ |