ข้อมูลประจําตัว

ข้อมูลประจําตัวของแหล่งข้อมูลสามารถแคชและนํามาใช้ใหม่ข้ามคําสั่งได้ ตามค่าเริ่มต้น แคชนี้ถูกเก็บไว้ในแฟ้มภายในเครื่องภายใต้ %LOCALAPPDATA%/Microsoft/pqtest และ ที่เข้ารหัสลับด้วยคีย์ผู้ใช้ปัจจุบัน

อีกทางเลือกหนึ่งสําหรับการจัดเก็บไฟล์ภายใน คุณสามารถจัดเก็บข้อมูลประจําตัวไว้ใน Azure Key Vaultได้ คุณสามารถเปิดใช้งานตัวเลือกนี้โดยใช้ตัวเลือก --keyVault / -kv ซึ่งมีชื่อชุดเก็บคีย์เป็นอาร์กิวเมนต์ตัวเลือก และตั้งค่าตัวแปรสภาพแวดล้อมที่ระบุในตารางต่อไปนี้:

โน้ต

เมื่อใช้ Azure Key Vault ข้อมูลประจําตัวจะถูกจัดเก็บเป็นวัตถุไบนารีเดียวแทนที่จะเป็นความลับเฉพาะ

ตัวแปร	ราย ละเอียด	ตัวอย่าง
PQTEST_AZURE_CLIENT_ID	ID (GUID) สําหรับแอปพลิเคชัน Microsoft Entra ID ที่ได้รับอนุญาตให้เข้าถึง Key Vault ของคุณ	a0a0a0a0-bbbb-cc-dddd-e1e1e1e1e1e1
PQTEST_AZURE_CLIENT_SECRET	ข้อมูลลับไคลเอ็นต์สําหรับแอปพลิเคชัน Microsoft Entra ID ของคุณ	< > ตัวยึดตําแหน่งข้อมูลลับไคลเอ็นต์
PQTEST_AZURE_TENANT_ID	ID (GUID) สําหรับผู้เช่าที่เป็นเจ้าของ Azure Key Vault	a0a0a0a0-bbbb-cc-dddd-e1e1e1e1e1e1
PQTEST_AZURE_KEY_VAULT_URL	URL ไปยังชุดเก็บคีย์	https://<myvault>.vault.azure.net

ตัวอย่างการใช้ตัวเลือก keyVault :

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

เทมเพลตข้อมูลประจําตัว

ใช้คําสั่งนี้เพื่อสร้างเทมเพลตข้อมูลประจําตัวในรูปแบบ JSON ที่สามารถส่งผ่านไปยังคําสั่ง ข้อมูลประจําตัว คําสั่ง ต้องการให้คุณใส่ ส่วนขยาย และแหล่งข้อมูล ถ้าแหล่งข้อมูลสนับสนุนการรับรองความถูกต้องมากกว่าหนึ่งชนิด คุณต้องระบุชนิดการรับรองความถูกต้องที่จะใช้กับตัวเลือก --authenticationKind / -ak

เทมเพลตผลลัพธ์มีค่าตัวแทนที่ระบุด้วยชื่อคีย์ ที่ควรแทนที่ก่อนที่จะส่งผ่านไปยังคําสั่ง ข้อมูลประจําตัวชุด

ตัวอย่างเช่น MyConnector สนับสนุนทั้งชนิดการรับรองความถูกต้องแบบไม่ระบุชื่อและ UsernamePassword

ในการสร้างข้อมูลประจําตัว Anonymous จะมีการใช้คําสั่งต่อไปนี้:

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

โน้ต

ค่า JSON ผลลัพธ์ไม่มีค่าตัวแทนข้อความใด ๆ เนื่องจากชนิด Anonymous ไม่จําเป็นต้องมี

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

คําสั่งต่อไปนี้จะถูกใช้เพื่อสร้างข้อมูลประจําตัว UsernamePassword สําหรับตัวเชื่อมต่อเดียวกัน:

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

เทมเพลตที่เป็นผลลัพธ์ประกอบด้วยค่าตัวแทนข้อความ $$USERNAME$$ และ $$PASSWORD$$

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

ตั้งค่าข้อมูลประจําตัว

ใช้คําสั่งนี้เพื่อจัดเก็บข้อมูลประจําตัวที่ใช้โดยคําสั่ง test-connection และ การทดสอบการใช้งาน คําสั่ง ต้องการให้คุณใส่ ส่วนขยาย และแหล่งข้อมูล คุณสามารถตั้งค่าข้อมูลประจําตัวได้สามวิธี:

• ใช้ข้อมูลประจําตัวในรูปแบบ JSON
• ข้อมูลประจําตัวอัตโนมัติสําหรับชนิดการรับรองความถูกต้องที่ไม่จําเป็นต้องมีการตั้งค่าเพิ่มเติม (Anonymous และ Windows)
• การใช้โหมดโต้ตอบ

ข้อมูลประจําตัวในรูปแบบ JSON

คุณสามารถตั้งค่าข้อมูลประจําตัวชนิดใดก็ได้โดยใช้รูปแบบข้อมูลประจําตัว JSON ใช้ คําสั่งเทมเพลตข้อมูลประจําตัว เพื่อสร้างข้อมูลประจําตัว JSON

เมื่อตั้งค่าข้อมูลประจําตัวโดยใช้เทมเพลต JSON อินพุตต้องถูกไปยังคําสั่งหรือระบุจาก stdin ผ่านไฟล์

ต่อไปนี้คือตัวอย่างของการตั้งค่าข้อมูลประจําตัวของ โดยการซ้อนผลลัพธ์ของคําสั่ง เทมเพลตข้อมูลประจําตัวของ ลงใน ข้อมูลประจําตัวชุด :

<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"
}

โน้ต

Anonymous และข้อมูลประจําตัว Windows สามารถตั้งค่าโดยใช้ ข้อมูลประจําตัวอัตโนมัติ

ต่อไปนี้คือตัวอย่างของการตั้งค่าข้อมูลประจําตัวจากไฟล์ที่จัดเก็บบนดิสก์ (โดยใช้การป้อนข้อมูลที่เปลี่ยนเส้นทาง):

<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"
}

ข้อมูลประจําตัวอัตโนมัติ

คุณสามารถตั้งค่าข้อมูลประจําตัว และ โดยไม่ต้องใส่แม่แบบข้อมูลประจําตัว

โน้ต

Windows ข้อมูลประจําตัวที่ตั้งค่าด้วยวิธีนี้เป็นค่าเริ่มต้นเพื่อใช้ข้อมูลประจําตัวของผู้ใช้ปัจจุบัน ใช้ คําสั่งแม่แบบข้อมูลประจําตัว เพื่อสร้างข้อมูลประจําตัว JSON ที่สามารถปรับเปลี่ยนเพื่อใช้ข้อมูลประจําตัวของบัญชีผู้ใช้ Windows อื่น

ในการสร้างข้อมูลประจําตัว Windows จะมีการใช้คําสั่งต่อไปนี้:

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

ในการสร้างข้อมูลประจําตัว Anonymous จะมีการใช้คําสั่งต่อไปนี้:

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

โหมดโต้ตอบ

คุณสามารถตั้งค่าข้อมูลประจําตัวได้โดยใช้โหมดโต้ตอบโดยใช้ตัวเลือกบรรทัดคําสั่ง --interactive

โหมดโต้ตอบสามารถใช้สําหรับ OAuth และชนิดการรับรองความถูกต้อง Aad การเรียกใช้คําสั่งในโหมดนี้จะแสดงกล่องโต้ตอบ OAuth ที่สามารถใช้ในการทดสอบการใช้งาน OAuth ของคุณได้

โฟลว์ OAuth แบบโต้ตอบใช้คอมโพเนนต์เบราว์เซอร์ WebView2 (Microsoft Edge Chromium) ซึ่งอาจจําเป็นต้องติดตั้งแยกต่างหาก คุณสามารถพบรายละเอียดเพิ่มเติมได้ในเอกสารประกอบ Power Query OAuth สําหรับ Power BI Desktop

ตัวเลือก --useLegacyBrowser สามารถใช้เพื่อบังคับให้หน้าต่างเบราว์เซอร์แบบฝังตัว IE11 ได้