Κοινή χρήση μέσω

Πλαίσιο δοκιμής SDK Power Query, μέρος 7 - Οδηγός διοχέτευσης

  • Άρθρο

Αυτή η αναφορά σε πολλά μέρη καλύπτει τη ρύθμιση και την εκτέλεση μιας τυπικής οικογένειας δοκιμών για προγραμματιστές συνδέσεων Power Query. Η αναφορά προορίζεται να γίνει διαδοχικά για να διασφαλιστεί ότι το περιβάλλον σας έχει ρυθμιστεί για δοκιμή της προσαρμοσμένης σύνδεσής σας.

Αυτός ο οδηγός σάς παρέχει τα βήματα που απαιτούνται για τη ρύθμιση μιας διοχέτευσης για το πλαίσιο δοκιμής SDK του Power Query.

Σε αυτήν την ενότητα, θα κάνετε τα εξής:

  • Επισκόπηση της ρύθμισης της διοχέτευσης
  • Ρύθμιση παράγοντα διοχέτευσης
  • Μάθετε πώς μπορείτε να ρυθμίσετε τις παραμέτρους της σύνδεσης, συμπεριλαμβανομένης της ρύθμισης του προγράμματος οδήγησης και των διαπιστευτηρίων
  • Εκτελέστε τις δοκιμές για να επαληθεύσετε τη σύνδεση επέκτασης
  • Δημιουργία της αναφοράς της εκτέλεσης δοκιμής

Οδηγός ρύθμισης διοχέτευσης για συνδέσεις Power Query

Αυτός ο οδηγός σάς παρέχει τα βήματα που απαιτούνται για τη ρύθμιση μιας διοχέτευσης για το πλαίσιο δοκιμής SDK του Power Query. Σε υψηλό επίπεδο, απαιτείται η ρύθμιση ενός παράγοντα, η ρύθμιση των παραμέτρων της σύνδεσης που δοκιμάζεται, συμπεριλαμβανομένης της ρύθμισης τυχόν προγραμμάτων οδήγησης, της ρύθμισης των διαπιστευτηρίων για το PQTest με τον υποστηριζόμενο μηχανισμό ελέγχου ταυτότητας, της εκτέλεσης των δοκιμών και της αναφοράς των αποτελεσμάτων. Αυτό το έγγραφο χρησιμοποιεί διοχετεύσεις και πόρους Azure για όλα τα παραδείγματά του. Ωστόσο, αυτές οι έννοιες μπορούν να εφαρμοστούν σε άλλες αρχιτεκτονικές διοχέτευσης.

Η διοχέτευση χρησιμοποιεί την ακόλουθη δομή:

  1. Ανακτήστε τις δοκιμές από ένα αποθετήριο δεδομένων.
  2. Ανακτήστε ή/και ορίστε τα διαπιστευτήρια για πρόσβαση στην προέλευση δεδομένων χρησιμοποιώντας τον υποστηριζόμενο μηχανισμό ελέγχου ταυτότητας.
  3. Εκτελέστε τις δοκιμές που ανακτήθηκαν στο προηγούμενο βήμα.
  4. Ενημερώστε τα αποτελέσματα και τα αρχεία καταγραφής.

Η τεκμηρίωση διοχετεύσεων Azure περιγράφει τον τρόπο ρύθμισης μιας βασικής διοχέτευσης. Ανατρέξτε στις παρακάτω ενότητες για συμβουλές σχετικά με τη ρύθμιση αυτών των δυνατοτήτων.

  • Προαπαιτούμενα παράγοντα
    • Δικτύωση
    • Δικαιώματα
    • PQTest
    • Προγράμματα οδήγησης
  • βεβαίωση αναγνώρισης
  • Δέσμες ενεργειών
    • Αυτοματοποιημένη πρόσβαση διαπιστευτηρίων
    • Εκτέλεση δοκιμών
    • Αυτοματοποίηση δεσμών ενεργειών

Προαπαιτούμενα παράγοντα

Ο παράγοντας διοχέτευσης πρέπει να περιλαμβάνει το Power Query SDK και να ρυθμιστεί ώστε να μπορεί να εκτελεί το PQTest. Αυτή η ρύθμιση παραμέτρων περιλαμβάνει πρόσβαση στη σχετική προέλευση δεδομένων και στη διαχείριση διαπιστευτηρίων, εάν υπάρχει.

Όλες αυτές οι απαιτήσεις μπορούν να ικανοποιηθούν με χρήση ενός αυτο-φιλοξενούμενου παράγοντα. Οι διοχετεύσεις Azure μπορούν να παρέχουν παράγοντες που φιλοξενούνται στη Microsoft, αλλά αυτοί οι παράγοντες είναι απίθανο να περιέχουν το SDK Power Query και ενδέχεται να υπάρχουν εμπόδια δικτύωσης που πρέπει να ληφθούν υπόψη. Η χρήση μιας εικονικής μηχανής ή ενός φυσικού υπολογιστή ως παράγοντα διοχέτευσης μπορεί να διασφαλίσει ότι το PQTest μπορεί να συνδεθεί στην προέλευση δεδομένων σας.

Δικτύωση

Για την εκτέλεση δοκιμών σύνδεσης, ο παράγοντας πρέπει να μπορεί να έχει πρόσβαση στη σχετική προέλευση δεδομένων. Οι προελεύσεις δεδομένων cloud (για παράδειγμα, Snowflake και Google Big Query) είναι πιθανώς εύκολα προσβάσιμες, ωστόσο οι προελεύσεις δεδομένων εσωτερικής εγκατάστασης (για παράδειγμα, SAP BW και SQL Server) χρειάζονται περισσότερες ρυθμίσεις παραμέτρων. Αυτές οι ρυθμίσεις παραμέτρων μπορεί να απαιτούν να εξασφαλίσετε ότι ο παράγοντας είναι συνδεδεμένος στο ίδιο εικονικό δίκτυο, ότι το τείχος προστασίας του παράγοντα επιτρέπει τις σωστές θύρες και ούτω καθεξής.

Δικαιώματα

Εάν η πρόθεσή σας είναι να αντλήσετε αυτόματα διαπιστευτήρια από έναν θάλαμο κλειδιών, ο παράγοντας χρειάζεται μια μέθοδο για να το κάνει. Η προτεινόμενη μέθοδος είναι να ορίσετε μια διαχειριζόμενη ταυτότητα για μια εικονική μηχανή και να εκχωρήσετε τα απαραίτητα δικαιώματα στον θάλαμο κλειδιών.

PQTest

Το εκτελέσιμο αρχείο PQTest πρέπει να είναι εγκατεστημένο στον παράγοντα. Η προτεινόμενη μέθοδος είναι να κάνετε λήψη του πακέτου Power Query SDK NuGet και να το αποσυμπιέζετε στον παράγοντα.

Το εκτελέσιμο αρχείο PQTest μπορεί να βρεθεί στον φάκελο Πακέτα NuGet \tools. Χρησιμοποιήστε το όρισμα --help για να εμφανίσετε πληροφορίες βοήθειας για PQTest.exe και να εξοικειωθείτε με τις εντολές του.

Προγράμματα οδήγησης

Για τις συνδέσεις ODBC, οποιαδήποτε προγράμματα οδήγησης πρέπει να προστεθούν σε έναν φάκελο Προγράμματα οδήγησης ODBC στην ακόλουθη διαδρομή:

<>power_query_sdk_extension_path\Microsoft.PowerQuery.SdkTools.2.xxx.x\tools\Προγράμματα οδήγησης<ODBC>

Παράδειγμα για το πρόγραμμα οδήγησης Contoso, η διαδρομή μπορεί να είναι η εξής:

C:\Users\ContosoUser.vscode\extensions\powerquery.vscode-powerquery-sdk-0.2.3-win32-x64.nuget\Microsoft.PowerQuery.SdkTools.2.126.3\tools\ODBC Driver\Contoso

βεβαίωση αναγνώρισης

Τα διαπιστευτήρια μεταβιβάζονται στο PQTest χρησιμοποιώντας είτε την επέκταση Visual Studio Code είτε την εντολή set-credential μέσω της γραμμής εντολών. Αφού οριστεί, αυτά τα διαπιστευτήρια μπορούν να χρησιμοποιηθούν ξανά για πολλαπλές εκτελέσεις δοκιμής.

Ανάλογα με τον τύπο ελέγχου ταυτότητας, αυτά τα διαπιστευτήρια μπορεί να χρειαστεί να οριστούν μόνο μία φορά (όνομα χρήστη/κωδικός πρόσβασης) ή να διατηρηθούν ενημερωμένα (διακριτικό ανανέωσης OAuth2). Η προηγούμενη υπόθεση μπορεί να ρυθμιστεί εύκολα χρησιμοποιώντας το περιβάλλον εργασίας του Visual Studio Code. Η δεύτερη περίπτωση μπορεί να επιτευχθεί δημιουργώντας μια δέσμη ενεργειών.

Δέσμες ενεργειών

Το PQTest μπορεί να χρησιμοποιηθεί εξ ολοκλήρου από τη γραμμή εντολών, η οποία επιτρέπει την αυτοματοποίηση μέσω δεσμών ενεργειών.

Αυτοματοποιημένη πρόσβαση διαπιστευτηρίων

Για να αυτοματοποιήσετε την πρόσβαση διαπιστευτηρίων για το PQTest, συνιστάται να χρησιμοποιήσετε έναν θάλαμο κλειδιών. Με αυτόν τον τρόπο, τα διαπιστευτήρια μπορούν να ανανεωθούν εύκολα και μπορείτε να δημιουργήσετε δέσμες ενεργειών.

  1. Το πρώτο βήμα είναι η εκχώρηση πρόσβασης στη διαχειριζόμενη ταυτότητα του παράγοντα.
  2. Στη συνέχεια, μπορείτε να καλέσετε ένα Rest API για πρόσβαση σε δεδομένα.

Τώρα που έχετε έναν τρόπο να βρείτε μυστικά, μπορείτε να τα προσθέσετε στο cache διαπιστευτηρίων του PQTest.

  1. Χρησιμοποιήστε την εντολή προτύπου διαπιστευτηρίων για να δημιουργήσετε ένα πρότυπο JSON. Αυτό το πρότυπο περιέχει κείμενο κράτησης θέσης ($$USERNAME$$, $$REFRESH_TOKEN$$και ούτω καθεξής), το οποίο μπορεί να τροποποιηθεί δυναμικά μέσω συναρτήσεων αντικατάστασης συμβολοσειράς.

    $keyVaultOutput = invoke-expression 'Get-AzKeyVaultSecret -VaultName $keyVaultName -Name $secretName -AsPlainText'
$jsonTemplate = invoke-expression "$pqTestExe credential-template -e $extensionFile -q $queryFile -ak $authenticationType"
$jsonCredential = $jsonTemplate.Replace('$$USERNAME$$', $credentialName)
$jsonCredential = $jsonCredential.Replace('$$PASSWORD$$', $keyVaultOutput)

  2. Διαβιβάστε το τροποποιημένο πρότυπο JSON στην εντολή set-credential χρησιμοποιώντας διοχέτευση (|) ή είσοδο (<).

    $jsonCredential | & $pqTestExe set-credential -e $extensionFile -q $queryFile

Τώρα που έχουν οριστεί τα διαπιστευτήρια, μπορούν να εκτελεστούν δοκιμές.

Σημείωση: Η εντολή list-credential μπορεί να χρησιμοποιηθεί για την επιβεβαίωση της σωστής ρύθμισης των διαπιστευτηρίων.

Εκτέλεση δοκιμών

Οι δοκιμές μπορούν να εκτελεστούν μέσω της εντολής χρησιμοποιώντας την εντολή σύγκρισης. Για παράδειγμα, για την εκτέλεση μιας μοναδικής δοκιμής:

.\PQTest.exe compare -e <connector file> -q <query file> -p

Για να εκτελέσετε πολλές δοκιμές:

.\PQTest.exe compare -e <connector file> -q <query folder> -sq <base query file> -p

Αυτοματοποίηση δεσμών ενεργειών

Οι δέσμες ενεργειών μπορούν να αυτοματοποιηθούν εκτελώντας τις από μια εργασία διοχέτευσης. Για τις διοχετεύσεις Azure, μπορεί να χρησιμοποιηθεί η εργασία PowerShell:

# Example Azure pipeline for running connector tests using PQTest.
# Azure Pipelines reference: https://aka.ms/yaml
trigger: none
pool:
  name: SelfHosted-AgentPool
steps:
  - task: PowerShell@2
    inputs:
      filePath: '<path_to_run_test_script>/RunConnectorTest.ps1'
    displayName: 'Run Connector Tests'

Συμπέρασμα

Αυτή η ενότητα σάς έδειξε πώς να ρυθμίσετε και να ρυθμίσετε τις παραμέτρους της διοχέτευσης για χρήση του πλαισίου δοκιμών SDK του Power Query, χρησιμοποιώντας την παρεχόμενη οικογένεια δοκιμών καθώς και τις δικές σας δοκιμές για να επικυρώσετε τη σύνδεση επέκτασης.

Συνολικά, θα πρέπει τώρα να μπορείτε να κάνετε αξιόπιστα αλλαγές στην επέκτασή σας και να την επικυρώσετε κατά τη διάρκεια της ανάπτυξης και της έκδοσης.