Freigeben über


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.

Der Screenshot, auf dem die Schaltfläche „Neu“ hervorgehoben ist, die Sie zum Erstellen globaler Parameter auswählen.

Geben Sie im Seitennavigationsbereich einen Namen ein, wählen Sie einen Datentyp aus, und geben Sie den Wert Ihres Parameters an.

Der Screenshot zeigt, wo Sie den Namen, Datentyp und Wert für den neuen globalen Parameter hinzufügen.

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.

Erstellen globaler Parameter

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>.

Verwenden von globalen Parametern

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.

Screenshot: In ARM-Vorlage einschließen

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“) Screenshot des veralteten „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.