共用方式為


處理閘道支援

測試連接

內部部署資料閘道 的個人和標準模式 都提供自訂連線or 支援。 這兩種閘道模式都支援 匯入 只有標準模式才支援直接查詢 。 透過閘道的自訂連接器 OAuth 目前僅支援閘道系統管理員,但不支援其他資料來源使用者。

當 Power BI 自訂資料連線或功能處於預覽狀態時,實作 Test連線ion 功能的方法可能會變更。

若要支援透過內部部署資料閘道排程重新整理,連接器 必須 實作 Test連線ion 處理常式。 當使用者設定來源的認證,並用來確保它們有效時,就會呼叫 函式。 Test連線ion 處理常式是在資料來源種類 記錄中 設定,且具有下列簽章:

(dataSourcePath) as list => ...

其中 dataSourcePath 是函式的 資料來源路徑 值,而傳回值是由下列專案所組成的清單:

  • 要呼叫的函式名稱(此函式必須標示為 #shared ,而且通常是您的主要資料來源函式)。
  • 要傳遞至函式的一或多個引數。

如果函式的叫用造成錯誤,則 Test連線ion 會被視為失敗,而且不會保存認證。

注意

如上所述,Test連線ion 所提供的函式名稱必須是 shared 成員。

範例:沒有必要引數連線or

下列程式碼片段會針對沒有必要參數的資料來源實作 Test連線ion(例如 TripPin 教學 課程中找到 的參數)。 沒有必要參數(稱為'Singletons') 的連線器不需要任何使用者提供的輸入來測試連線(認證以外的)。 在此情況下, dataSourcePath 值會等於資料來源種類的名稱,而且可以忽略。 未使用其他參數叫用函 TripPin.Contents 式。

TripPin = [
    TestConnection = (dataSourcePath) => { "TripPin.Contents" },
    Authentication = [
        Anonymous = []
    ],
    Label = "TripPin"
];

範例:使用 URL 參數連線or

如果您的資料來源函式具有類型的 Uri.Type 單一必要參數,則其 dataSourcePath 會等於使用者提供的 URL。 下列程式碼片段顯示 Github 範例 中的 Test連線ion 實作。

GithubSample = [
    TestConnection = (dataSourcePath) => {"GithubSample.Contents", dataSourcePath},
    Authentication = [
        OAuth = [
            StartLogin = StartLogin,
            FinishLogin = FinishLogin,
            Label = Extension.LoadString("AuthenticationLabel")
        ]
    ]
];

範例:具有必要參數連線or

如果您的資料來源函式有多個參數或單一非 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"
];