Globale Parameter in Azure Data Factory

  • Artikel

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.

Screenshot that highlights the New button you select to create global parameters.

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

Screenshot that shows where you add the name, data type, and value for the new global parameter.

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.

Create global parameters

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

Using global parameters

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.

Screenshot of 'Include in ARM template'.

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“) Screenshot of deprecated 'Include in ARM template'.

  • 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