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 einer Pipeline in beliebigen Ausdrücken verbraucht 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 oder setzt diese außer Kraft, wie dies früher der Fall war, weshalb keine zusätzliche PowerShell für die Bereitstellung globaler Parameter während der CI/CD erforderlich ist.
Hinweis
Wir haben die Benutzeroberflächenerfahrung zum Einschließen von globalen Parametern 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.
Wenn Sie den älteren Flow für die Integration globaler Parameter in Ihre Continuous Integration- und Continuous Deployment-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. Wenn Sie das tun, wird die Fehlermeldung „{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=Der Ausdruck >'pipeline().globalParameters.myparam-dbtest-url' ist ungültig: .....}“ 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.