次の方法で共有

接続参照変数の種類 (プレビュー)

接続参照変数は、 外部データ接続の ID (Snowflake、Azure SQL など) を格納するワークスペース変数です。これにより、アイテムは資格情報や接続文字列を埋め込まずに外部リソースを参照できます。

使用方法

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

  1. Microsoft Fabric にサインインする
  2. ワークスペースと変数ライブラリに移動する
  3. 上部にある [+ 新しい変数] を選択します。
  4. 変数の名前を指定し、型の 接続参照 を選択し、 ... をクリックして値を選択します。

接続参照で使用できる項目のスクリーンショット。 5. 選択すると、接続参照を使用する準備が整います。

接続参照のスクリーンショット。

接続参照を編集する必要がある場合、または値を再確認する必要がある場合は、値を右クリックして、接続参照に関する情報をポップアップ表示できます。

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

どのように機能するのか

接続参照変数の値は、その接続 ID で識別される接続オブジェクトへの静的ポインターです。 値は、ターゲット接続の ID に対応する文字列として格納されます。 例えば次が挙げられます。

ConnectionID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

この ID は、参照先の接続を一意に識別します。 静的参照は、異なるデプロイ環境に自動的に調整されることはありません。 選択時にターゲット接続が存在する必要があり、手動で変更しない限り、その特定の接続を指し続けます。

接続参照を操作するときは、次の点に注意してください。

  • テナント レベルで定義済みの接続識別子を格納します。
  • デプロイ中、接続参照は自動バインドされません。 これらの値は、環境間で固定されたままです。
  • さまざまな環境 (開発、テスト、prod) の外部接続をパラメーター化することで、CI/CD と自動化をサポートします。
  • 外部リレーションシップの動的な構成を有効にします (たとえば、環境ごとのデータ ソースまたは資格情報の切り替え)。
  • 値は、フリー テキストではなく UI ダイアログを使用して選択され、承認された接続のみを選択できます。
  • 選択できるのは、少なくとも読み取りアクセス許可を持つ接続のみです。

Git と API での表現

接続参照は、値スキーマが connectionId (およびプラットフォームの解決/表示メタデータ) を格納する高度な変数型です。 オーサリング ペイロードには、次のものが含まれます。

  • name: 接続参照変数の表示名
  • 注: 省略可能。説明やその他のメモに使用できます。
  • type: "connectionReference" (高度な型)
  • value: 各value-setごとに、各値が「connectionId": "<GUID/ID文字列>」を格納します。

例：


  {
   "name": "PrimaryDb",
   "note": "",
   "type": "connectionReference",
   "value": { "connectionId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" }
  }

接続参照を作成/使用するために必要なアクセス許可

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

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

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

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

接続参照変数をサポートする項目の一覧を次に示します。

Python コードの例

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

var_ref = "$(/**/VarLibItem/ConnectionReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
connection_id = var_obj.get("connectionId").value()
print(connection_id)

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

  • ファブリック変数ライブラリから接続参照変数を解決します。
  • 接続メタデータ オブジェクトを取得します。
  • connectionId を抽出します。
  • コードまたは API 呼び出しで使用できるように ID を出力します。

制限事項

接続参照変数には、次の制限事項が適用されます。

  • Notebook 接続のconnection_idは同じではないため、ノートブックの組み込み接続はサポートされていません。

関連するコンテンツ

  • Last updated on