Freigeben über

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

Microsoft Fabric verwendet Variablenbibliotheken in Arbeitsbereichen, um Konstanten über Pipelines und andere Datenfabrik- und Fabric-Elemente zu definieren. Sie können globale ADF-Parameter mit wenigen manuellen Schritten zu Fabric Variablenbibliotheken migrieren.

Dieser Leitfaden führt Sie durch den Prozess:

  • Exportieren Ihrer globalen ADF-Parameter
  • Erstellen von Arbeitsbereichsvariablen in Fabric
  • Aktualisieren von Pipelineausdrücken
  • Überprüfen des Verhaltens

Grundlegendes zur Fabric Variablenbibliothek

Die Fabric Variablenbibliothek speichert Werte auf Arbeitsbereichsebene, auf die Sie über Pipelines und Aktivitäten verweisen können. 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 globalen ADF-Parametern bieten Fabric Variablen strengere Sicherheit, einfachere Wiederverwendung und bessere Governance-Steuerelemente. Sie können sie auf alle Fabric Elemente anwenden. Weitere Informationen finden Sie unter "Erste Schritte mit Variablenbibliotheken".

Migrieren globaler ADF-Parameter zu Fabric Variablenbibliothek

  1. Exportieren Sie die globalen ADF-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 die globalen ADF-Parametertypen (Zeichenfolge, Int, Bool usw.), und vergleichen Sie sie mit Fabric Variablenbibliothekstypen. 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. Öffnen Sie Die neue Variablenbibliothek, wählen Sie +Neue Variable und jeden globalen ADF-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 ADF-Parameter wie Regions- oder Mandantennamen werden eins zu eins Variablenbibliothekseinträgen 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 die integrierte Upgradeerfahrung noch das PowerShell-Migrationstool migriert 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

  • Last updated on