Globale Parameter in Azure Data Factory
GILT FÜR:
Azure Data Factory 
Azure Synapse Analytics
Tipp
Testen Sie Data Factory in Microsoft Fabric, eine All-in-One-Analyselösung für Unternehmen. Microsoft Fabric deckt alle Aufgaben ab, von der Datenverschiebung bis hin zu Data Science, Echtzeitanalysen, Business Intelligence und Berichterstellung. Erfahren Sie, wie Sie kostenlos eine neue Testversion starten!
Globale Parameter sind Konstanten in einer Data Factory, die von Pipelines in beliebigen Ausdrücken genutzt werden können. Sie sind hilfreich, wenn Sie über mehrere Pipelines mit identischen Parameternamen und -werten verfügen. Beim Höherstufen einer Data Factory per CI/CD-Prozess (Continuous Integration/Deployment) können Sie diese Parameter in einer Umgebung jeweils außer Kraft setzen.
Erstellen globaler Parameter
Navigieren Sie zum Erstellen eines globalen Parameters im Abschnitt Verwalten zur Registerkarte Globale Parameter. Wählen Sie Neu aus, um den Seitennavigationsbereich für die Erstellung zu öffnen.
Geben Sie im Seitennavigationsbereich einen Namen ein, wählen Sie einen Datentyp aus, und geben Sie den Wert Ihres Parameters an.
Nachdem ein globaler Parameter erstellt wurde, können Sie ihn bearbeiten, indem Sie auf seinen Namen klicken. Wählen Sie zum gleichzeitigen Ändern mehrerer Parameter die Option Edit all (Alle bearbeiten) aus.
Verwenden globaler Parameter in einer Pipeline
Globale Parameter können in jedem Pipelineausdruck verwendet werden. Wenn eine Pipeline auf eine andere Ressource verweist, z. B. ein Dataset oder einen Datenfluss, können Sie den Wert des globalen Parameters über die Parameter dieser Ressource an die untergeordneten Elemente übergeben. Auf globale Parameter wird wie folgt verwiesen: pipeline().globalParameters.<parameterName>.
Globale Parameter in CI/CD
Es wird empfohlen, globale Parameter in die ARM-Vorlage während der CI/CD aufzunehmen. Der neue Mechanismus zum Einschließen globaler Parameter in die ARM-Vorlage (aus „Hub verwalten“ > „ARM-Vorlage“ > „Globale Parameter in ARM-Vorlage einschließen“), wie unten dargestellt, steht nicht in Konflikt mit den Einstellungen auf Factoryebene und setzt diese nicht außer Kraft, wie dies früher der Fall war, weshalb kein zusätzlicher PowerShell-Code für die Bereitstellung globaler Parameter während CI/CD erforderlich ist.
Hinweis
Die Benutzeroberflächenoption zum Einschließen globaler Parameter wurde aus dem Abschnitt „Globale Parameter“ in den Abschnitt „ARM-Vorlage“ im Verwaltungshub verschoben.
Wenn Sie bereits den älteren Mechanismus verwenden (aus „Hub verwalten“ > „Globale Parameter“ > „In ARM-Vorlage einschließen“), können Sie fortfahren. Wir unterstützen diesen weiterhin.
Der Ordner Parameter in der heruntergeladenen ARM-Vorlage enthält JSON-Dateien, die die in der ARM-Vorlage verwendeten Parameter definieren. Jede Datei entspricht einem bestimmten globalen Parameter.
Wenn Sie den älteren Flow für die Integration globaler Parameter in Ihre CI/CD-Lösung verwenden, funktioniert dies weiterhin:
Einschließen globaler Parameter in die ARM-Vorlage (aus „Hub verwalten“ -> „Globale Parameter“ -> „In ARM-Vorlage einschließen“)
Bereitstellen globaler Parameter über ein PowerShell-Skript
Es wird dringend empfohlen, den neuen Mechanismus zum Einschließen globaler Parameter in die ARM-Vorlage zu verwenden (aus „Hub verwalten“ -> „ARM-Vorlage -> „Globale Parameter in eine ARM-Vorlage einschließen“), da dies die Verwaltung der CI/CD mit globalen Parametern wesentlich vereinfacht und klarer gestaltet.
Hinweis
Die Konfiguration Globale Parameter in ARM-Vorlage einschließen ist nur im „Git-Modus“ verfügbar. Im „Livemodus“ und Data Factory-Modus ist sie derzeit deaktiviert.
Warnung
Sie können das Zeichen „-“ nicht im Parameternamen verwenden. In diesem Fall wird die Fehlermeldung „{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=The expression >'pipeline().globalParameters.myparam-dbtest-url' isn't valid: .....}“ angezeigt. Stattdessen können Sie das Zeichen „_“ im Parameternamen verwenden.
Zugehöriger Inhalt
- Informieren Sie sich über den CI/CD-Prozess (Continuous Integration/Deployment) von Azure Data Factory.
- Informieren Sie sich über die Nutzung der Ausdruckssprache für die Ablaufsteuerung.