다음을 통해 공유

연결 참조 변수 형식(미리 보기)

연결 참조 변수는 외부 데이터 연결의 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: 연결 참조 변수의 'displayName'
  • 참고: 선택 사항으로 설명 또는 기타 노트에 사용할 수 있습니다.
  • 형식: "connectionReference"(고급 형식)
  • value: value-set당, 각 값은 { "connectionId": "<GUID/ID 문자열>" }

Example:


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

연결 참조를 만들거나 사용하는 데 필요한 권한

연결 참조 변수를 사용하려면 다음 두 가지 권한 계층이 포함됩니다.

  • 연결 참조 변수 만들기 및 편집: 작업 영역에서 기여자 이상의 역할을 가진 사용자는 라이브러리에서 변수를 만들고 편집할 수 있지만 뷰어는 읽기 전용입니다.
  • 연결 참조 변수 액세스: 변수 라이브러리에 대한 권한 외에도 참조하려는 연결 참조 변수에 대한 읽기 권한이 있어야 합니다 .

사용 권한 및 권한 유효성 검사에 대한 자세한 내용은 변수 라이브러리 사용 권한을 참조하세요.

지원되는 항목

다음은 연결 참조 변수를 지원하는 항목 목록입니다.

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 동일하지 않으므로 Notebook의 기본 제공 연결은 지원되지 않습니다.

관련 콘텐츠

  • Last updated on