Konvertiere Azure Data Factory globale Parameter in Fabric Data Factory-Variablenbibliotheken

Fabric verwendet variable Bibliotheken in Arbeitsbereichen, um Konstanten über Pipelines und andere Data Factory- und Fabric-Objekte hinweg zu definieren. Du kannst globale Azure Data Factory-Parameter mit ein paar manuellen Schritten in Fabric-Variablenbibliotheken migrieren.

Dieser Leitfaden führt Sie durch den Prozess:

  • Exportieren Sie Ihre globalen Parameter von Azure Data Factory
  • Erstellen von Arbeitsbereichsvariablen in Fabric
  • Aktualisieren von Pipelineausdrücken
  • Überprüfen des Verhaltens

Grundlegendes zur Fabric Variablenbibliothek

Die Variablenbibliothek in Fabric speichert Workspace-Werte, die du über Pipelines und Aktivitäten hinweg referenzieren kannst. Es unterstützt Typen wie Zeichenfolge, Zahl und boolesche Werte sowie sichere Werte für geheime Schlüssel. Sie können Variablenbibliotheken versionieren und in Umgebungen mit Bereitstellungspipelinen bereitstellen.

Im Gegensatz zu den globalen Parametern der Azure Data Factory bieten Fabric-Variablen eine strengere Sicherheit, eine einfachere Wiederverwendung und bessere Governance-Kontrollen. Sie können sie auf alle Fabric Elemente anwenden. Weitere Informationen finden Sie unter "Erste Schritte mit Variablenbibliotheken".

Migrieren Sie globale Parameter von Azure Data Factory in die Fabric-Variablenbibliothek

  1. Exportiere deine globalen Azure Data Factory-Parameter.

    1. Wechseln Sie in Azure Data Factory Studio zu Manage>Global Parameters. Notieren Sie den Namen, den Typ und den Wert jedes Parameters.
    2. Für große Migrationen wechseln Sie zu "ARM-Vorlage>", und exportieren Sie ARM-Vorlagen, um Parameter programmgesteuert zu extrahieren. Sie finden diese im Vorlagenordner unter dem Factory-Ordner in der Datei, die auf ParametersForFactory endet.

  2. Vergleichen Sie die verfügbaren Typen.

    Überprüfen Sie Ihre globalen Parametertypen der Azure Data Factory (String, int, Bool usw.) und vergleichen Sie sie mit den Variablenbibliothekstypen von Fabric. Notieren Sie sich alle Typunterschiede, die während der Migration möglicherweise Anpassungen erfordern.

  3. Erstellen einer Variablenbibliothek in Fabric.

    1. Wählen Sie in Ihrem Fabric-Arbeitsbereich + Neues Element aus und suchen Sie dann nach Variablenbibliothek.
    2. Erstellen Sie eine Bibliothek (z. B. GlobalParams).
    3. Öffne deine neue Variablenbibliothek, wähle +Neue Variable und jeden globalen Azure Data Factory-Parameter als Variable aus.

    Weitere Informationen zum Erstellen von Variablenbibliotheken finden Sie unter "Erste Schritte mit Variablenbibliotheken".

  4. Aktualisieren sie migrierte Pipelineausdrücke.

    Aktualisieren Sie globale Parameterverweise wie @globalParameters('ParamName') zu Variablenbibliotheksverweisen wie @pipeline.libraryVariables.ParamName.

    Aktualisieren Sie alle Aktivitätsausdrücke, Verbindungszeichenfolgen, Skriptargumente, Filterlogik und Dataseteigenschaften. Weitere Informationen finden Sie unter Integration der Variablenbibliothek mit Datenpipelines.

  5. Überprüfen des Pipelineverhaltens.

    Führen Sie Validierungs- und Testläufe aus, um zu bestätigen, dass Variablen in Ihren Pipelines korrekt aufgelöst werden. Überprüfen Sie, ob Verbindungen, Parameterbindungen und sichere Variablenverwendung wie erwartet funktionieren.

Allgemeine Migrationsmuster

Im Folgenden sind einige Migrationsmuster aufgeführt, die Sie beim Konvertieren globaler Parameter in Variablenbibliotheken verwenden können:

  • Direkte Zuordnung — Einfache Azure Data Factory-Parameter wie Region oder Mandantenname werden Einträgen der Variablenbibliothek eins zu eins zugeordnet.

  • Umgebungsspezifische Bibliotheken – Statt einer Bibliothek erstellen Sie mehrere Bibliotheken (Global-Dev, Global-Test, Global-Prod). Bereitstellungspipelines können die richtige Bibliothek basierend auf der Umgebung verknüpfen.

  • Hybridmodell – Behalten Sie freigegebene Konstanten in der Variablenbibliothek bei, übermitteln Sie jedoch laufzeitspezifische Informationen über Pipeline-Parameter.

Aktuelle Einschränkungen

Derzeit gibt es einige Einschränkungen, die Sie beachten sollten:

  • Weder das integrierte Upgrade-Erlebnis noch das PowerShell-Upgrade-Tool aktualisieren automatisch globale Parameter.
  • Ausdrücke in verknüpften Diensten oder Pipelines, die @globalParameters() referenzieren, werden nicht automatisch umgeschrieben.
  • Fabric Verbindungen (der Ersatz für Azure Data Factory verknüpfte Dienste) unterstützen Parameterausdrücke nicht auf die gleiche Weise. Sie müssen alle dynamischen Parameter, die in Verbindungsdefinitionen verwendet werden, manuell erneut erstellen.

Bewährte Methoden

Beachten Sie diese Tipps:

  • Richten Sie die Benennungskonventionen vor der Migration aus.
  • Vermeiden Sie das Überladen von Variablen auf Arbeitsbereichsebene. Verwenden Sie stattdessen Pipelineparameter für Laufzeitwerte.
  • Verwenden Sie Bereitstellungspipelinen zum Verwalten von umgebungsspezifischen Variablenbibliotheken.
  • Dokumentieren Sie Ihre Variablebibliothek, damit Teammitglieder wissen, welche Pipelines von welchen Variablen abhängig sind.

Verwandte Inhalte

  • Zuletzt aktualisiert um