KQL データベースに OneLake ショートカットを作成する

OneLake は、Microsoft Fabric がレイクハウス、ウェアハウス、KQL データベース、その他のアイテムを保存する、単一の統合された論理データ レイクです。 ショートカットは、元のデータを移動せずに他のファイルの保存場所を指す、OneLake 内の埋め込み参照です。 埋め込み参照によりファイルとフォルダーはローカルに保存されているように見えますが、実際、これらは別のストレージの場所に存在します。 ショートカットはアイテムから更新または削除できますが、これらの変更は元のデータとそのソースには影響しません。

この記事では、内部 Fabric または外部ソースを指す KQL データベースで OneLake ショートカットを 作成する方法について説明します。 このようなショートカットは、後で「external_table() 関数」を使用して KQL クエリセットのクエリにアクセスします。 KQL データベースで作成されたショートカットの名前を変更することはできません。また、一度に作成できるショートカットは 1 つのみです。

KQL データベースからショートカットを作成するだけでなく、他の Fabric 項目からショートカットを作成することもできます。 これらのショートカットは、内部 Fabric または外部ソースに格納されているデータも指しますが、制限が異なってアクセス方法が異なります。 詳しくは、「OneLake のショートカット」をご覧ください。

前提条件

• Microsoft Fabric 対応容量を持つワークスペース
• 編集アクセス許可を持つ KQL データベース
• レイクハウス

他の Microsoft Fabric エクスペリエンスで KQL データベース内のデータにアクセスするには、「1 つの論理コピー」をご覧ください。

ショートカットの作成

1. 既存の KQL データベースを参照します。

2. + > New>OneLake ショートカットを選択します。

   

ソースを選択する

OneLake では、内部 OneLake リソース (KQL データベース、レイクハウス、ウェアハウスなど) と外部リソース (Azure Data Lake Storage、Amazon S3、Google Cloud Storage など) の両方へのショートカットがサポートされています。 サポートされているすべてのショートカットの種類と、その特定の構成手順へのリンクの一覧については、「 OneLake ショートカット」 > ショートカットの種類を参照してください。

KQL データベースのショートカットは 、クエリ アクセラレーションをサポートします。 新しいショートカットでクエリ アクセラレーションを有効にするには、[高速化] ボタンを [オン] に切り替えます。

ショートカットを作成すると、データベースが自動的に更新されます。 [エクスプローラー] ウィンドウの [ショートカット] にショートカットが表示されます。 このデータに対してクエリを実行できるようになりました。

データのクエリ

OneLake ショートカットからのデータに対してクエリを実行するには、external_table() 関数を使用します。

1. データベースの右端で、[データの探索] を選択します。 いくつかのクエリ例と共にウィンドウが開くので、クエリ例を実行して、データの初期状態を確認できます。
2. テーブル名のプレースホルダーをexternal_table('ショートカット名')に置き換えます。
3. [実行] を選択するか、[Shift キー + Enter キー]を押して選択されたクエリを実行します。

データ型のマッピング

Delta Parquet からイベントハウスのデータ型へのマッピング

デルタ プリミティブ データ型は、次のルールを使用してイベントハウスのスカラー データ型にマップされます。 イベントハウスのデータ型の使用の詳細については、「スカラー データ型」に関するページをご覧ください。

関連するコンテンツ

• KQL クエリセット内のデータにクエリを実行する
• external_table() 関数
• OneLake ショートカットに対するクエリの高速化