Important
Azure Synapse Analytics データ エクスプローラー (プレビュー) は、2025 年 10 月 7 日に廃止されます。 この日以降、Synapse Data Explorer で実行されているワークロードは削除され、関連付けられているアプリケーション データは失われます。 Microsoft Fabric の Eventhouse に移行 することを強くお勧めします。
Microsoft Cloud Migration Factory (CMF) プログラムは、お客様が Fabric に移行できるように設計されています。 このプログラムは、顧客に無料でハンズオン キーボード リソースを提供します。 これらのリソースは、定義済みの合意されたスコープで、6 ~ 8 週間割り当てられます。 顧客の指名は、Microsoft アカウント チームから受け入れられるか、CMF チームに ヘルプの要求 を送信することによって直接受け入れられます。
データ インジェストは、テーブルにデータを追加し、データ エクスプローラーでクエリに使用できるようにするプロセスです。
with キーワードの後に、インジェスト コマンドにプロパティを追加します。
取り込み特性
次の表に、データ エクスプローラーでサポートされるプロパティの一覧を示し、その説明と例を示します。
| プロパティ | Description | Example |
|---|---|---|
ingestionMapping |
ソース ファイルからテーブル内の実際の列にデータをマップする方法を示す文字列値。 関連するマッピングの種類を使用して format 値を定義します。 「データ マッピング」を参照してください。 |
with (format="json", ingestionMapping = "[{\"column\":\"rownumber\", \"Properties\":{\"Path\":\"$.RowNumber\"}}, {\"column\":\"rowguid\", \"Properties\":{\"Path\":\"$.RowGuid\"}}]")(非推奨: avroMapping、 csvMapping、 jsonMapping) |
ingestionMappingReference |
名前付きマッピング ポリシー オブジェクトを使用して、ソース ファイルからテーブル内の実際の列にデータをマップする方法を示す文字列値。 関連するマッピングの種類を使用して format 値を定義します。 「データ マッピング」を参照してください。 |
with (format="csv", ingestionMappingReference = "Mapping1")(非推奨: avroMappingReference、 csvMappingReference、 jsonMappingReference) |
creationTime |
取り込まれたデータ エクステントの作成時に使用する datetime 値 (ISO8601文字列として書式設定)。 指定しない場合は、現在の値 (now()) が使用されます。 既定値をオーバーライドすると、古いデータを取り込むときに、保持ポリシーが正しく適用されるように便利です。 指定した場合は、ターゲット テーブルの有効なLookbackの プロパティが、指定した値と一致していることを確認します。 |
with (creationTime="2017-02-13") |
extend_schema |
指定した場合、テーブルのスキーマを拡張するようにコマンドに指示するブール値 (既定値は false)。 このオプションは、 .append コマンドと .set-or-append コマンドにのみ適用されます。 許可されるスキーマ拡張機能の末尾には、テーブルに列が追加されているだけです。 |
元のテーブル スキーマが (a:string, b:int)されている場合、有効なスキーマ拡張機能は (a:string, b:int, c:datetime, d:string)されますが、 (a:string, c:datetime) は有効ではありません |
folder |
ingest-from-query コマンドの場合、フォルダーをテーブルに割り当てる。 テーブルが既に存在する場合、このプロパティはテーブルのフォルダーをオーバーライドします。 | with (folder="Tables/Temporary") |
format |
データ形式 ( サポートされているデータ形式を参照)。 | with (format="csv") |
ingestIfNotExists |
指定した場合に、テーブルに同じ値を持つ ingest-by: タグでタグ付けされたデータが既に存在する場合、取り込みが成功しないようにする文字列値。 これにより、イデンポテントなデータ インジェストを保証します。 詳細については、「インジェストバイ: タグ」を参照してください。 |
プロパティ with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') 、タグを持つデータ ingest-by:Part0001 既に存在する場合は、現在のインジェストを完了しないことを示します。 まだ存在しない場合は、この新しいインジェストにこのタグが設定されている必要があります (将来のインジェストが同じデータを再度取り込もうとした場合)。 |
ignoreFirstRecord |
trueに設定されている場合、インジェストはすべてのファイルの最初のレコードを無視する必要があることを示すブール値です。 このプロパティは、ファイル内の最初のレコードが列名である場合、 CSVおよび同様の形式のファイルに役立ちます。 既定では、 false が想定されます。 |
with (ignoreFirstRecord=false) |
persistDetails |
指定された場合、コマンドで詳細な結果を保持する必要があることを示すブール値です。これにより、成功時もshow 操作の詳細コマンドで情報を取得できます。 既定値は false です。 |
with (persistDetails=true) |
policy_ingestiontime |
指定した場合、このコマンドによって作成されたテーブルに対して インジェスト時間ポリシー を有効にするかどうかを示すブール値。 既定値は trueです。 |
with (policy_ingestiontime=false) |
recreate_schema |
指定した場合、コマンドがテーブルのスキーマを再作成できるかどうかを示すブール値。 このプロパティは、 .set-or-replace コマンドにのみ適用されます。 両方が設定されている場合、このプロパティは extend_schema プロパティよりも優先されます。 |
with (recreate_schema=true) |
tags |
JSON 文字列として書式設定された、取り込まれたデータに関連付ける タグ の一覧 | with (tags="['Tag1', 'Tag2']") |
validationPolicy |
インジェスト中に実行する検証を示す JSON 文字列。 さまざまなオプションの説明については、「 データ インジェスト 」を参照してください。 |
with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (これは実際には既定のポリシーです) |
zipPattern |
ZIP アーカイブがあるストレージからデータを取り込む場合は、このプロパティを使用します。 これは、取り込む ZIP アーカイブ内のファイルを選択するときに使用する正規表現を示す文字列値です。 アーカイブ内の他のすべてのファイルは無視されます。 | with (zipPattern="*.csv") |
次のステップ
- データ インジェストの詳細を確認します。
- サポートされているデータ形式の詳細を確認します。