Tunnistetiedot

Tietolähteen tunnistetiedot voidaan tallentaa välimuistiin ja käyttää uudelleen komentojen välillä. Oletusarvoisesti välimuisti tallennetaan paikalliseen tiedostoon kohtaan %LOCALAPPDATA%/Microsoft/pqtest ja se salattu nykyisellä käyttäjäavaimella.

Voit paikallisen tiedostosäilön sijaan tallentaa tunnistetiedot Azure Key Vaultin . Voit ottaa tämän asetuksen käyttöön käyttämällä --keyVault / -kv -asetusta, antamalla avainsäilön nimen asetusargumenttina ja määrittämällä seuraavassa taulukossa määritetyt ympäristömuuttujat:

Muistiinpano

Kun käytät Azure Key Vaultia, tunnistetiedot tallennetaan yksittäisenä binaariobjektina yksittäisten salaisten koodien sijaan.

Muuttuja	Tiedot	Otos
PQTEST_AZURE_CLIENT_ID	Sen Microsoft Entra ID -sovelluksen tunnus (GUID), jolla on oikeus käyttää Key Vaultiasi.	a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1e1
PQTEST_AZURE_CLIENT_SECRET	Microsoft Entra ID -sovelluksesi asiakassalaisuus.	<client-secret-paikkamerkki>
PQTEST_AZURE_TENANT_ID	Sen vuokraajan tunnus (GUID), joka omistaa Azure Key Vaultin.	a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1e1
PQTEST_AZURE_KEY_VAULT_URL	Key Vaultin URL-osoite.	https://<myvault>.vault.azure.net

Esimerkki keyVault -asetuksen käytöstä:

set PQTEST_AZURE_CLIENT_ID="a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1"
set PQTEST_AZURE_CLIENT_SECRET="<client-secret-placeholder>"
set PQTEST_AZURE_TENANT_ID="a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1"
set PQTEST_AZURE_KEY_VAULT_URL="https://myvault.vault.azure.net"

<Path to PQTest.exe>.\PQTest.exe list-credential --keyVault secretName

Tunnistetietomalli

Tällä komennolla voit luoda JSON-muodossa tunnistetietomallin, joka voidaan välittää set-credential -komentoon. Komento edellyttää, että annat -laajennuksen ja tietolähteen tiedot. Jos tietolähde tukee useampaa kuin yhtä todennuslajia, sinun on määritettävä, mitä todennuslajia käytetään --authenticationKind / -ak-vaihtoehdossa.

Tulostemallissa on paikkamerkkiarvoja, $$<avaimen nimi on>$$ jotka tulee korvata ennen niiden välittämistä set-credential -komennolle.

MyConnector esimerkiksi tukee sekä anonyymiä todentamista että käyttäjänimipassword-todennustyyppejä.

Anonymous tunnistetietojen luomiseen käytetään seuraavaa komentoa:

<Path to PQTest.exe>.\PQTest.exe credential-template --extension MyConnector.mez --queryFile MyConnectorQuery.m --prettyPrint --authenticationKind Anonymous

Muistiinpano

JSON-tuloste ei sisällä paikkamerkkiarvoja, koska Anonymous laji ei vaadi mitään.

{
  "AuthenticationKind": "Anonymous",
  "AuthenticationProperties": {},
  "PrivacySetting": "None",
  "Permissions": []
}

Seuraavaa komentoa käytetään käyttäjänimiPassword-tunnistetietojen luomiseen samalle liittimelle:

<Path to PQTest.exe>.\PQTest.exe credential-template --extension MyConnector.mez --queryFile MyConnectorQuery.m --prettyPrint --authenticationKind UsernamePassword

Tuloksena saatava malli sisältää $$USERNAME$$ ja $$PASSWORD$$ paikkamerkkiarvot.

{
  "AuthenticationKind": "UsernamePassword",
  "AuthenticationProperties": {
    "Username": "$$USERNAME$$",
    "Password": "$$PASSWORD$$"
  },
  "PrivacySetting": "None",
  "Permissions": []
}

Joukkotunnistetiedot

Tämän komennon avulla voit tallentaa testiyhteyden käyttämät tunnistetiedot ja run-test -komennot. Komento edellyttää, että annat -laajennuksen ja tietolähteen tiedot. Tunnistetiedot voidaan määrittää jollakin kolmesta tavasta:

• Tunnistetietojen käyttäminen JSON-muodossa.
• Automaattiset tunnistetiedot todennustyypeille, jotka eivät edellytä lisäasetuksia (Anonymous ja Windows).
• Vuorovaikutteisen tilan käyttäminen.

Tunnistetiedot JSON-muodossa

Minkä tahansa tunnistetietolajin voi määrittää käyttämällä JSON-tunnistetietomuotoa. Luo tunnistetiedot JSON -tunnistetietomallikomennon.

Kun määrität tunnistetietoja JSON-mallin avulla, syöte on johdettava komentoon tai annettava stdin tiedoston kautta.

Tässä on esimerkki Anonymous tunnistetietojen määrittämisestä putkella tunnistetietomallin -komennon tulos set-credential:

<Path to PQTest.exe>.\PQTest.exe credential-template -e MyConnector.mez -q MyConnectorQuery.m -p -ak Anonymous | pqtest set-credential -e MyConnector.mez -q MyConnectorQuery.m -p

{
  "Details": {
    "Kind": "MyConnector",
    "Path": "MyConnector",
    "NormalizedPath": "MyConnector",
    "IsDefaultForKind": false
  },
  "Message": "Successfully set credential",
  "Status": "Success"
}

Muistiinpano

Anonymous ja Windows tunnistetiedot voidaan määrittää käyttämällä automaattisia tunnistetietoja.

Tässä on esimerkki tunnistetietojen määrittämisestä levylle tallennetusta tiedostosta (uudelleenohjatun syötteen avulla):

<Path to PQTest.exe>.\PQTest.exe set-credential -e MyConnector.mez -q MyConnectorQuery.m -p < mySavedCredential.json

{
  "Details": {
    "Kind": "MyConnector",
    "Path": "MyConnector",
    "NormalizedPath": "MyConnector",
    "IsDefaultForKind": false
  },
  "Message": "Successfully set credential",
  "Status": "Success"
}

Automaattiset tunnistetiedot

Voit määrittää Anonymous ja Windows tunnistetiedot antamatta tunnistetietomallia.

Muistiinpano

Windows tunnistetiedot määritetään tällä tavalla oletusarvoisesti nykyisen käyttäjän käyttäjätietojen käyttämiseksi. luo tunnistetietomallikomennon avulla JSON-tunnistetiedot, joita voidaan muokata käyttämään vaihtoehtoisia Windows-tilin tunnistetietoja.

Windows tunnistetietojen luomiseen käytetään seuraavaa komentoa:

<Path to PQTest.exe>.\PQTest.exe set-credential -e MyConnector.mez -q MyConnectorQuery.m -p --authenticationKind windows

Anonymous tunnistetietojen luomiseen käytetään seuraavaa komentoa:

<Path to PQTest.exe>.\PQTest.exe set-credential -e MyConnector.mez -q MyConnectorQuery.m -p --authenticationKind anonymous

Vuorovaikutteinen tila

Tunnistetiedot voidaan määrittää vuorovaikutteisessa tilassa käyttämällä - vuorovaikutteinen -komentoriviasetusta.

Vuorovaikutteista tilaa voidaan käyttää todentamistyyppien OAuth ja Aad. Komennon suorittaminen tässä tilassa avaa OAuth-valintaikkunan, jonka avulla voit testata OAuth-toteutusta.

Vuorovaikutteiset OAuth-työnkulut käyttävät WebView2 (Microsoft Edge Chromium) -selainkomponenttia, joka on ehkä asennettava erikseen. Lisätietoja löytyy power BI Desktopin Power Query OAuth -.

--useLegacyBrowser -asetusta voidaan käyttää upotetun IE11-selainikkunan pakottamiseen.