項目参照変数の型 (プレビュー)

柔軟性とスケーラビリティを高めるために、既存の基本変数型と共に高度な変数を導入します。 これらの高度な変数は、外部接続と内部接続 (Snowflake、AWS、OneLake など) のパラメーター化などの主要な要件を満たすように設計されています。

item 参照変数は、ワークスペース ID と項目 ID を格納することによって、Fabric変数ライブラリ内で使用される高度な変数型です。これは、lakehouse、Notebook、データ パイプラインなどの既存のFabric項目への参照を保持するために使用されます。 この種類の変数を使用すると、内部接続のパラメーター化が可能になり、開発者はデプロイ ステージまたはワークスペース コンテキストに基づいて項目を特定のFabric項目に動的にリンクできます。

使用方法

項目参照変数は、変数ライブラリ内の他の変数と同様に使用できます。

  1. Microsoft Fabricにサインインする
  2. ワークスペースと変数ライブラリに移動する
  3. 上部にある [+ 新しい変数] を選択します。
  4. 変数の名前を指定し、型の 項目参照 を選択し、 ... をクリックして値を選択します。
  5. これにより、目的の項目を選択するダイアログが開きます。 アクセス許可を持っているすべての項目が表示され、選択できます。 左側のエクスプローラーを使用して、ワークスペースで一覧をフィルター処理します。 右上隅のフィルターを使用して、種類でフィルター処理します。

項目参照で使用可能な項目のスクリーンショット。 6. 選択すると、varlib ページに次のように表示されます。項目の名前を示す読み取り専用コンポーネントとして表示されます。

項目参照のスクリーンショット。

項目参照を編集する必要がある場合、または値を再確認する必要がある場合:

  • 追加の詳細を表示するには、値をクリックします
  • この値または他の値セットの値を編集するには、値の横にあるボタンをクリックします。

項目参照ポップアップのスクリーンショット。

動作方法

Item Reference 変数の値は、基本的には、Workspace ID + Item ID によって識別されるFabric項目への静的ポインターです。 この値は、ターゲット 項目のワークスペースと項目自体に対応する GUID のペアとして格納されます。 たとえば、参照は内部的に次のように格納される場合があります。

  • WorkspaceID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
  • ItemID = 00aa00aa-bb11-cc22-dd33-44ee44ee44ee

これら 2 つの ID は、参照される項目を一意に識別します。

項目参照を操作する場合は、次の点に注意してください。

  • 項目参照を使用すると、内部接続のパラメーター化が可能になり、開発者はデプロイ ステージまたはワークスペース コンテキストに基づいて、特定のFabric リソースに項目を動的にリンクできます。
  • 参照は静的であり、特定の項目を指しており、環境間で自動的に調整されるわけではありません。
  • ステージ固有のバリエーションの場合は、値セットを使用します。各セットは、異なる静的項目 (ステージごとに異なるレイクハウスなど) を指すことができます。
  • 互換性を確保し、実行時エラーを防ぐために、値セット全体のすべての値が同じ項目の種類である 必要があります 。 ただし、値セット間で同じ項目の種類を持つことは強制されません。

Git と API での表現

変数ライブラリはコードとして管理されます。 Git または REST API を使用すると、項目参照変数の JSON 形式が明確になります。 すべての変数は、変数ライブラリの定義ファイル (Git に格納され、通常は .json)、名前、型、値などのプロパティの一覧に表示されます。

項目参照 (静的) 変数の場合、値はワークスペース ID と項目 ID の構造化データです。 例:


{
 "name": "MyDataLake",
 "note": "",
 "type": "ItemReference",
 "value": {
  "itemId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
 }
}

API を使用する場合は、次の点に注意してください。

  • ID のみが格納されます。名前とメタデータは実行時に取得されるか、Fabricにキャッシュされます。
  • API を使用した作成/更新では、ワークスペース ID と項目 ID を指定します。 無効な ID を指定するとエラーが発生します。

サポートされているアイテム

項目参照を使用して現在サポートされている項目の一覧を次に示します。

注

%%configure経由のノートブックはサポートされていません。

Pythonコード例

次のコード例は、Python スクリプトで項目参照を使用する方法を示しています。

var_ref = "$(/**/VarLibItem/itemReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
workspace_id = var_obj.get("workspaceId").value()
item_id = var_obj.get("itemId").value()
print(workspace_id)
print(item_id)

このコードでは、次の処理が行われます。

  • Fabric変数ライブラリから項目参照変数を解決します。
  • 参照先アイテムのメタデータ オブジェクトを取得します。
  • ワークスペース ID と項目 ID を抽出します
  • プログラムで使用できるように印刷します。

アイテム参照変数の作成/使用に必要なアクセス許可

項目参照変数の使用には、次の 2 つのアクセス許可レイヤーが含まれます。

  • アイテム参照変数を作成および編集する: ワークスペースの共同作成者以上のロールを持つユーザーは、ライブラリ内で変数を作成および編集できますが、閲覧者は読み取り専用です。
  • 項目参照変数へのアクセス: 変数ライブラリの権限に加えて、参照する アイテム参照変数に対する読み取り権限が少なくとも必要 です。

アクセス許可とアクセス許可の検証の詳細については、「変数ライブラリのアクセス許可」を参照してください。

制限事項

現時点では、ファブリック項目とセマンティック モデルのみを参照できます。 Dataflow Gen1 などの他のPower BI項目は現在サポートされていません。

追加情報

変数ライブラリを使用すると、ステージ固有の構成に対して項目参照変数を使用し、環境 (開発、テスト、本番) 全体のFabricコンテンツに対してCI/CDを有効にします。 次の点に注意してください。

  • アイテム参照は、特定のワークスペースとアイテム ID に関連付けられます。
  • 新しいステージにデプロイする場合、手動で更新しない限り、これらの参照は引き続き元のワークスペースを指します。
  • ステージごとに複数の Value-Sets を使用し、適切なセットを手動で、または API スクリプトを使用してアクティブ化します。

詳細については、 変数ライブラリの値セットを参照してください。

関連コンテンツ

  • Last updated on