Azure Synapse Analytics サーバーレス SQL プール用の Azure Synapse Link のトラブルシューティング
適用対象:Azure Synapse Analytics
この記事では、Azure Synapse Analytics サーバーレス SQL プールの Azure Synapse Link で発生する一般的な問題の解決策について説明します。
Azure Synapse Link for Dataverse
Data Export Service (DES) の非推奨化
以下の記事を参照して、Data Export Service から Azure Synapse Link for Dataverse に移行する方法を確認します。
- DES 非推奨化プレイブック
- Data Export Services (DES) - 非推奨化に関するメモ
- Data Export Service から Azure Synapse Link for Dataverse へ
凖リアルタイム データと読み取り専用スナップショット データ
Dataverse 用の Azure Synapse Link を作成すると、Azure Synapse Analytics または Azure Data Lake Storage Gen2 で同期されるテーブル データの 2 つのバージョンが存在します。
| テーブルの種類です。 | 説明 |
|---|---|
| 凖リアルタイム データ | Azure Synapse Link を使用して Dataverse から同期されたデータのコピーを、最初に抽出または最後に同期されてから変更されたデータを検出することで、効率的な方法で提供します。 |
| スナップショット データ | 一定間隔 (この場合は 1 時間ごと) に更新される、ほぼリアルタイムのデータの読み取り専用コピーを提供します。 |
詳細については、「凖リアルタイム データと読み取り専用のスナップショット データにアクセスする」を参照してください。
増分更新 (プレビュー)
Azure Synapse ワークスペースで Azure Synapse Link for Dataverse を作成するときに、増分更新機能を有効にして、ユーザー指定の時間間隔中に発生した Dataverse データに対する変更のみを含む一連のタイムスタンプ付きフォルダーを作成できます。
詳細については、「増分更新のクエリと分析 (プレビュー)」を参照してください。
Azure Synapse Link for Azure Cosmos DB
Azure Cosmos DB データへのアクセス
Spark プールとサーバーレス SQL プールを使用して、分析ストア内の Azure Cosmos DB データに対してクエリを実行できます。 これらの記事の手順に従って、一般的な問題を解決します。
Azure Cosmos DB コンテナーのクエリを実行できない
Azure Synapse Link と Azure Cosmos DB アカウントの分析ストアが正しく構成されていることを確認します。
スキーマ表現について
分析ストアには、2 つのスキーマ表現モードがあります。 これらのモードでは、ポリモーフィック型スキーマを処理する列形式の表現の簡略さと、クエリ エクスペリエンスの簡略さとの間でトレードオフがあります。
- 適切に定義されたスキーマ表現 (Azure Cosmos DB SQL API の既定値)
- 完全に忠実なスキーマ表現 (MongoDB 用の Azure Cosmos DB API の既定値)
分析ストアのスキーマを自動的に処理する方法について説明します。
クエリ結果にプロパティ (列) が見つからない
Azure Cosmos DB コンテナーに存在する列がない場合は、スキーマ制約に違反している可能性があります。 分析ストアがスキーマを自動的に推論して正しく表せるようにすると、Azure Cosmos DB の運用データに次の制約が適用されます。
- ドキュメント スキーマ内のすべての入れ子になったレベルで最大 1,000 個のプロパティを持ち、最大入れ子深度は 127 にすることができます。
- 分析ストアでは、最初の 1,000 個のプロパティのみが表されます。
- 分析ストアでは、最初の 127 個の入れ子のレベルのみが表示されます。
- JSON ドキュメントの最初のレベルは、その ルート レベルです。
- ドキュメントの最初のレベルのプロパティは、列として表示されます。
スキーマ制約の詳細については、「 Analytical store - Overview」を参照してください。
削除を含め、すべてのトランザクション操作が伝達されます。 分析ストアの Time to Live (TTL) 設定が原因で、データが削除される場合もあります。
- トランザクション ストアでドキュメントが削除された場合、両方のストアの TTL に関係なく、分析ストアからも削除されます。
- トランザクション TTL が分析 TTL より小さい場合、データはトランザクション ストアからアーカイブされますが、構成された TTL 制限まで分析ストアに保持されます。
- トランザクション TTL が分析 TTL よりも大きい場合、データは分析ストアからアーカイブされ、構成された TTL 制限までトランザクション ストアに保持されます。
- SQL API を使用する場合、スキーマは既定で明確に定義されています。つまり、コレクション内の最初のドキュメントで分析ストア スキーマが定義されます。 ドキュメントが最初のドキュメントのスキーマに準拠していない場合、分析ストアに同期されません。