REST スキーマでテーブルの列メタデータを取得するタイミングを指定します。メタデータは起動時または初回使用時に読み込むことができます。

Possible Values

OnUse, OnStart

データ型

string

デフォルト値

"OnUse"

解説

GetColumnsMetadata プロパティは、REST スキーマ使用時にconnector がテーブルの列メタデータを取得およびキャッシュするタイミングを制御します。 これは、クエリの開始速度と事前読み込みの量に影響します。利用可能なオプションは以下のとおりです。

• OnStart — connector は最初のステートメントを実行する前に、すべてのテーブルのすべての列のメタデータを取得してキャッシュします。これによりクエリ中の遅延を低減できますが、初期接続時間が増加する場合があります。
• OnUse — connector は各テーブルが最初にクエリされた時点でメタデータを取得してキャッシュします。起動時間を短縮できますが、テーブルへの初回アクセス時に遅延が生じる場合があります。

このプロパティは、複数のテーブルへの即時クエリ応答性と接続時間の短縮のバランスを取るのに役立ちます。

パフォーマンスに関する考慮事項

起動時にメタデータを取得すると、すべての列定義を事前に読み込むことで後のクエリ遅延を低減できますが、特に大規模なデータセットでは接続時間が大幅に増加する場合があります。 使用時にメタデータを取得すると接続が速くなりますが、メタデータがオンデマンドで読み込まれるため、各テーブルへの最初のクエリが遅延する場合があります。