同じテナントのOneLakeショートカットを作成する

この記事では、テナント内の別のFabricアイテム内のデータを指すOneLakeショートカットの作成方法を学びます。

ショートカットの概要については、「OneLake のショートカット」を参照してください。 プログラムでショートカットを作成するには、「OneLake ショートカット REST API」を参照してください。

前提条件

OneLake の Lakehouse または KQL データベース。 これらのいずれかを持っていない場合は、次の手順に従って、テスト用の レイクハウスを作成します:レイクハウスを作成します。

ショートカットを作成する

  1. Lakehouse または KQL データベースを開きます。

  2. エクスプローラー ウィンドウ内のディレクトリを右クリックします。

  3. メニューから新しいショートカットを作成します。

    • レイクハウスで、Lakehouse の設定に応じて、[ 新しいショートカット]、[ 新しいテーブル ショートカット]、または [新しいスキーマ ショートカット ] を選択します。
    • KQL データベースで、 +>New>OneLake ショートカットを選択します。

    レイク ビューで [新しいショートカット] を選択する場所を示すスクリーンショット。

  4. [内部ソース] で、[Microsoft OneLake] を選びます。

    使用可能なショートカット ソースを示す [新しいショートカット] ウィンドウのスクリーンショット。OneLake というタイトルのオプションが強調表示されています。

  5. 接続するデータ ソースを選び、[次へ] を選択します。

    ショートカットで使用できるデータ ソースを表示する [データ ソース タイプの選択] ウィンドウのスクリーンショット。[次へ] ボタンが強調表示されます。

    Tip

    別のFabricテナントのデータに接続したい場合は、クロステナントのOneLakeショートカットを作成する手順に従ってください。

  6. 接続方法を選択します。

    • パススルー (既定値): ターゲット データへのアクセスには、各ユーザーの ID が使用されます。 次の手順に進みます。

    • 委任された ID: 構成された接続 ID は、各ユーザーの ID ではなくターゲット データにアクセスするために使用されます。 このオプションを選択した場合は、[ 接続 ] を選択し、接続を構成します。 詳細については、「 委任認証」をご覧ください。

      委任された接続を構成するには:

      1. [既存の接続] を選択し、一覧から接続を選択するか、[新しい接続] を選択して接続を作成します。
      2. 新しい接続の場合は、接続の詳細を入力します。
      • パス: OneLake パスを確認または入力します。
      • 接続: 新しい接続の作成を選択します。
      • 接続名: 認識可能な名前を入力します。
      • 認証の種類: 組織アカウント または サービス プリンシパルを選択します。
        • 組織アカウントの場合は、[サインインして認証を完了する] を選択します。
          • Service principalには、テナントID、アプリケーション(クライアント)ID、クライアントシークレットを入力します。
      1. 次へを選択します。
  7. [ファイル] または [テーブル] を展開して、使用可能なサブフォルダーを表示します。 有効な Delta テーブルまたは Iceberg テーブルを含む tables ディレクトリ内のサブフォルダーは、テーブル アイコンで示されます。 テーブル セクション内のファイルまたは不明なフォルダーは、フォルダー アイコンで示されます。

    レイクハウスの展開されたテーブルディレクトリとファイルディレクトリを示すスクリーンショット。

  8. 接続するサブフォルダーを 1 つ以上選択し、[次へ] を選択します。

    OneLake でショートカットを作成するときに、最大 50 個のサブフォルダーを選択できます。

    レイクハウスのデータを示す [新しいショートカット] ウィンドウのスクリーンショット。

  9. 選択したショートカットの場所を確認します。 編集アクションを使用して、既定のショートカット名を変更します。 削除アクションを使用して、不要な選択をすべて削除します。 ショートカットを生成するには、[作成] を選択します。

    選択したショートカットの場所を示し、選択内容を削除または名前変更するオプションが表示される [新しいショートカット] ウィンドウのスクリーンショット。

レイクハウスは自動で更新されます。 ショートカットは、[Explorer] ペインで選択したディレクトリの下に表示されます。 通常のファイルまたはテーブルとそのプロパティのショートカットを区別できます。 プロパティには、アイテムがショートカットであることを示す ショートカットの種類 パラメーターがあります。

ショートカット記号が表示されるフォルダーのレイク ビュー リストを示すスクリーンショット。

既存のショートカットを編集または削除するには、「 OneLake ショートカットを編集または削除する」を参照してください。