연결 테스트
사용자 지정 커넥터 지원은 온-프레미스 데이터 게이트웨이의 개인 및 표준 모드 모두에서 사용할 수 있습니다. 두 게이트웨이 모드 모두 가져오기를 지원합니다. 직접 쿼리 는 표준 모드에서만 지원됩니다. 게이트웨이를 통한 사용자 지정 커넥터에 대한 OAuth는 현재 게이트웨이 관리자만 지원되지만 다른 데이터 원본 사용자는 지원되지 않습니다.
Power BI 사용자 지정 데이터 커넥터 기능이 미리 보기 상태인 동안 TestConnection 기능을 구현하는 방법은 변경됩니다.
온-프레미스 데이터 게이트웨이를 통해 예약된 새로 고침을 지원하려면 커넥터가 TestConnection 처리기를 구현 해야 합니다 . 이 함수는 사용자가 원본에 대한 자격 증명을 구성할 때 호출되며 유효한지 확인하는 데 사용됩니다. TestConnection 처리기는 데이터 원본 종류 레코드에 설정되며 다음 서명이 있습니다.
(dataSourcePath) as list => ...
함수에 대한 dataSourcePath 값이고, 반환 값은 다음으로 구성된 목록입니다.
- 호출할 함수의 이름입니다(이 함수는 일반적으로 기본 데이터 원본 함수로
#shared표시되어야 합니다). - 함수에 전달할 인수 하나 이상입니다.
함수를 호출하면 오류가 발생하면 TestConnection이 실패한 것으로 간주되고 자격 증명이 유지되지 않습니다.
비고
위에서 설명한 대로 TestConnection에서 제공하는 함수 이름은 멤버여야 shared 합니다.
예: 필수 인수가 없는 커넥터
아래 코드 조각은 필수 매개 변수가 없는 데이터 원본에 대한 TestConnection을 구현합니다(예: TripPin 자습서에 있는 코드). 필수 매개 변수가 없는 커넥터('Singletons'라고 함)는 사용자가 제공한 입력을 사용하여 연결을 테스트할 필요가 없습니다(자격 증명 이외의). 이 경우 값은 dataSourcePath 데이터 원본 종류의 이름과 같으며 무시될 수 있습니다.
함수는 TripPin.Contents 추가 매개 변수 없이 호출됩니다.
TripPin = [
TestConnection = (dataSourcePath) => { "TripPin.Contents" },
Authentication = [
Anonymous = []
],
Label = "TripPin"
];
예: URL 매개 변수가 있는 커넥터
데이터 원본 함수에 형식 Uri.TypedataSourcePath 의 단일 필수 매개 변수가 있는 경우 해당 매개 변수는 사용자가 제공한 URL과 같습니다. 아래 코드 조각은 Github 샘플의 TestConnection 구현을 보여줍니다.
GithubSample = [
TestConnection = (dataSourcePath) => {"GithubSample.Contents", dataSourcePath},
Authentication = [
OAuth = [
StartLogin = StartLogin,
FinishLogin = FinishLogin,
Label = Extension.LoadString("AuthenticationLabel")
]
]
];
예: 필수 매개 변수가 있는 커넥터
데이터 원본 함수에 여러 매개 변수 또는 URL이 아닌 단일 매개 변수 dataSourcePath 가 있는 경우 값은 매개 변수를 포함하는 JSON 문자열이 됩니다. 아래 코드 조각은 DirectQueryForSQL 샘플에서 제공됩니다.
DirectSQL = [
TestConnection = (dataSourcePath) =>
let
json = Json.Document(dataSourcePath),
server = json[server],
database = json[database]
in
{ "DirectSQL.Database", server, database },
Authentication = [
Windows = [],
UsernamePassword = []
],
Label = "Direct Query for SQL"
];