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

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 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: In ARM-Vorlage einschließen

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.

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