Erstellen, Konfigurieren und Verwenden einer Umgebung in Fabric

Eine Microsoft Fabric-Umgebung ist ein Arbeitsbereichselement, das die Spark-Sitzungskonfiguration für Notizbücher und Spark-Auftragsdefinitionen definiert. Verwenden Sie eine Umgebung, um eine Spark-Runtime auszuwählen, Computeeinstellungen zu konfigurieren, Bibliotheken zu verwalten und kleine Ressourcendateien zu verwalten, auf die Notizbücher zugreifen können.

Dieser Artikel enthält eine Übersicht über das Erstellen, Konfigurieren und Verwenden einer Umgebung.

Gründe für die Verwendung eines Umgebungselements

Sie können Notizbücher und Spark-Auftragsdefinitionen mithilfe von Arbeitsbereichsstandard ausführen, ohne ein Umgebungselement anzufügen. In diesem Fall verwenden Sie Spark-Einstellungen auf Arbeitsbereichsebene.

Verwenden Sie ein Umgebungselement, wenn Sie wiederverwendbare Standardeinstellungen für Teams benötigen:

• Definieren Sie die Spark-Compute- und -Bibliotheken einmal, und wenden Sie sie konsistent für Notebooks und Spark-Auftragsdefinitionen an.
• Legen Sie eine Umgebung als Standard für den Arbeitsbereich fest, damit Benutzer die freigegebene Konfiguration über den Arbeitsbereich-Standard erben.
• Versions- und Betriebsumgebungseinstellungen als einzelnes Artefakt.

Umgebungen auf Arbeitsbereichsebene

Verwenden Sie diesen Workflow, wenn Sie arbeitsbereichweite Standardeinstellungen für Notizbücher und Spark-Auftragsdefinitionen festlegen möchten.

Ein Umgebungselement wird in einem bestimmten Arbeitsbereich erstellt und diesem Arbeitsbereich zugeordnet. Sie können diese Umgebung auch in anderen Arbeitsbereichen verwenden, auf die Sie Zugriff haben, wenn freigabe- und Arbeitsbereichskompatibilitätsanforderungen erfüllt sind.

Erstellen einer Umgebung aus einem Arbeitsbereich

1. Wechseln Sie in Ihrem Browser zum Fabric-Arbeitsbereich im Fabric-Portal.

2. Wählen Sie + Neues Element aus.

3. Suchen Sie in der Suchleiste nach "Umgebung", und wählen Sie die Kachel " Umgebung " aus.

   

4. Benennen Sie Ihre Umgebung, und wählen Sie "Erstellen" aus.

Anfügen einer Umgebung als Arbeitsbereichstandard

Arbeitsbereichsadministrator*innen können die Standardarbeitslast für ganze Arbeitsbereiche definieren. Die hier konfigurierten Werte gelten für Notebooks und Spark-Auftragsdefinitionen, die an Arbeitsbereichseinstellungen angefügt werden.

Die Umschaltfläche "Standardumgebung festlegen" steuert, ob der Standard des Arbeitsbereichs von einem Umgebungselement hinterlegt ist.

1. Wechseln Sie in Ihrem Browser zum Fabric-Arbeitsbereich im Fabric-Portal.

2. Wählen Sie Arbeitsbereichseinstellungen aus.

3. Wählen Sie "Data Engineering/Science" und dann "Spark"-Einstellungen aus.

4. Wählen Sie die Registerkarte Umgebung aus.

   

5. Wenn Sie einen umgebungsbasierten Arbeitsbereich verwenden möchten, aktivieren Sie " Standardumgebung festlegen " auf "Ein", wählen Sie das Umgebungselement aus, das Sie verwenden möchten, und speichern Sie dann Ihre Änderungen.

   • Wenn dieser Umschalter deaktiviert ist (Standardeinstellung), wird benutzern weiterhin die Standardeinstellung "Arbeitsbereich " in Notizbüchern und Spark-Auftragsdefinitionen angezeigt. In diesem Zustand verwendet Arbeitsbereich standardmäßig Spark-Einstellungen auf Arbeitsbereichsebene.
   • Wenn dieser Umschalter aktiviert ist, wählen Sie ein Umgebungselement als Standardarbeitsbereich aus. Notizbücher und Spark-Auftragsdefinitionen, die Workspace-Standard verwenden, erben dann die Spark-Compute- und Bibliothekskonfigurationen dieser Umgebung.

   

Umgebungen auf Notizbuch- und Spark-Auftragsdefinitionsebene

Verwenden Sie diesen Workflow, wenn Sie Umgebungen direkt aus einem Notizbuch oder einer Spark-Auftragsdefinition erstellen, auswählen oder ändern möchten.

Erstellen oder Ändern einer Umgebung aus einer Notizbuch- oder Spark-Auftragsdefinition

1. Wechseln Sie in Ihrem Browser zum Fabric-Arbeitsbereich im Fabric-Portal.

2. Öffnen Sie eine Notizbuch- oder Spark-Auftragsdefinition.

3. Wählen Sie die Dropdownliste "Umgebung" und dann " Neue Umgebung" aus.

   

   Hinweis

   Wenn Sie die Umgebung auch ändern möchten, ohne eine neue Umgebung zu erstellen, können Sie im Dropdownmenü " Umgebung ändern " auswählen. Sie können eine vorhandene Umgebung auswählen und dann "Bestätigen " auswählen, um sie an die Notizbuch- oder Spark-Auftragsdefinition anzufügen.

4. Benennen Sie Ihre Umgebung, und wählen Sie "Erstellen" aus.

Anfügen einer Umgebung an ein Notebook oder eine Spark-Auftragsdefinition

Die Umgebung ist sowohl auf den Registerkarten „Notizbuch“ als auch auf den Registerkarten „Spark Job Definition“ verfügbar. Wenn Notizbücher und Spark-Auftragsdefinitionen an eine Umgebung angefügt sind, können sie auf ihre Bibliotheken, Computekonfigurationen und Ressourcen zugreifen. Im Explorer werden alle verfügbaren Umgebungen aufgelistet, die für Sie freigegeben sind, aus dem aktuellen Arbeitsbereich stammen und von anderen Arbeitsbereichen stammen, auf die Sie Zugriff haben.

Wenn Sie während einer aktiven Sitzung zu einer anderen Umgebung wechseln, wird die neu ausgewählte Umgebung erst nach der nächsten Sitzung wirksam.

Wenn Sie eine Umgebung aus einem anderen Arbeitsbereich anfügen, müssen beide Arbeitsbereiche über die gleichen Kapazitäts- und Netzwerksicherheitseinstellungen verfügen. Obwohl Sie Umgebungen aus Arbeitsbereichen mit unterschiedlichen Kapazitäten oder Netzwerksicherheitseinstellungen auswählen können, kann die Sitzung nicht gestartet werden.

Wenn Sie eine Umgebung aus einem anderen Arbeitsbereich anhängen, wird die Computer-Konfiguration in dieser Umgebung ignoriert. Stattdessen werden in den Pool- und Computekonfigurationen standardmäßig die Einstellungen des aktuellen Arbeitsbereichs festgelegt.

Konfigurieren einer Umgebung

Eine Umgebung verfügt über drei Hauptkomponenten:

• Spark-Compute, das die Spark-Laufzeitumgebung enthält.
• Bibliotheken.
• Ressourcen.

Die Spark-Compute- und Bibliothekskonfigurationen sind erforderlich, damit die Veröffentlichung wirksam ist. Ressourcen sind gemeinsam genutzter Speicher, der sich in Echtzeit ändern kann. Weitere Informationen finden Sie unter Speichern und Veröffentlichen von Änderungen.

Konfigurieren von Spark-Compute

Konfigurieren Sie Spark compute in einer Umgebung, indem Sie eine Laufzeit auswählen und Computeeigenschaften auf Sitzungsebene festlegen.

Ausführliche Schritte, einschließlich Laufzeitauswahl und Computeanpassung, finden Sie unter Spark Compute-Konfigurationseinstellungen in Fabric-Umgebungen.

Wenn Sie Laufzeit- oder Computeeinstellungen ändern, speichern und veröffentlichen Sie die Umgebung, damit diese Änderungen wirksam werden. Weitere Informationen finden Sie unter Speichern und Veröffentlichen von Änderungen.

Verwalten von Bibliotheken

Jede Spark-Laufzeit stellt integrierte Bibliotheken bereit. Mit der Fabric-Umgebung können Sie bibliotheken auch aus öffentlichen Quellen installieren oder benutzerdefinierte Bibliotheken hochladen, die Sie oder Ihre Organisation erstellt haben. Nachdem Sie die Bibliotheken erfolgreich installiert haben, sind sie in Ihren Spark-Sitzungen verfügbar. Weitere Informationen finden Sie unter Bibliotheksverwaltung in Fabric-Umgebungen. Die bewährten Methoden zum Verwalten von Bibliotheken in Fabric finden Sie unter Verwalten von Apache Spark-Bibliotheken in Fabric.

Verwenden von Ressourcen

Der Abschnitt "Ressourcen " in einer Umgebung erleichtert die Verwaltung kleiner Ressourcen während der Entwicklungsphase. Dateien, die in die Umgebung hochgeladen wurden, sind über Notizbücher zugänglich, wenn sie angefügt sind. Weitere Informationen finden Sie unter Verwalten der Ressourcen in einer Fabric-Umgebung.

Speichern und Veröffentlichen von Änderungen

Verwenden Sie "Speichern " und " Veröffentlichen ", um zu steuern, wann Änderungen an der Umgebungskonfiguration wirksam werden.

• Speichern Sie Ihre ausstehenden Änderungen.
• Die Veröffentlichung wendet ausstehende Änderungen an Bibliotheken und Spark Compute an.
• Änderungen in Ressourcen sind in Echtzeit und erfordern keine Veröffentlichung.

Auf der Registerkarte " Start " sind "Speichern " und " Veröffentlichen " aktiviert, wenn ausstehende Änderungen in Bibliotheken oder Spark compute vorhanden sind.

Wenn ausstehende Änderungen vorhanden sind, stellt ein Banner auch Speichern - und Veröffentlichen-Aktionen bereit.

Verwenden Sie diesen Workflow:

1. Nehmen Sie Änderungen in Bibliotheken oder Spark compute vor.
2. Wählen Sie "Speichern" aus, um Ihre Bearbeitungen beizubehalten. Gespeicherte Änderungen werden stufenweise und noch nicht wirksam.
3. Wählen Sie "Veröffentlichen" und dann " Alle veröffentlichen " aus, um die mehrstufigen Änderungen wirksam zu machen.

Während der Veröffentlichung:

• Um einen Veröffentlichungsprozess abzubrechen, wählen Sie im Banner "Fortschritt anzeigen" aus, und brechen Sie den Vorgang ab.
• Nach Abschluss der Veröffentlichung wird eine Benachrichtigung angezeigt. Wenn während des Prozesses Probleme auftreten, tritt eine Fehlerbenachrichtigung auf.

Eine Umgebung akzeptiert jeweils nur eine Veröffentlichungsaktion . Sie können während einer laufenden Veröffentlichung keine Änderungen an den Bibliotheken oder Spark-Compute vornehmen.

Freigeben einer vorhandenen Umgebung

Fabric ermöglicht die Freigabe eines Elements mit unterschiedlichen Berechtigungsstufen.

Wenn Sie ein Umgebungselement freigeben, erhalten Empfänger automatisch Lesen-Berechtigung. Mit dieser Berechtigung können sie die Konfigurationen der Umgebung erkunden und an Notizbücher oder Spark-Aufträge anfügen. Achten Sie bei der reibungslosen Codeausführung darauf, Leseberechtigungen für angefügte Umgebungen zu erteilen, wenn Sie Notizbücher und Spark-Auftragsdefinitionen freigeben.

Sie können die Umgebung auch mit Freigabe- und Bearbeitungsberechtigungen teilen. Benutzer mit Freigabeberechtigung können die Umgebung weiterhin mit anderen teilen. In der Zwischenzeit können Empfänger mit der Berechtigung "Bearbeiten" den Inhalt der Umgebung aktualisieren.

Eine Umgebung löschen

Sie können eine Umgebung löschen, wenn sie nicht mehr benötigt wird. Berücksichtigen Sie vor dem Löschen einer Umgebung Folgendes:

Löschen einer Umgebung mithilfe der REST-API

Sie können eine Umgebung programmgesteuert mithilfe der Fabric-REST-API löschen:

Endpunkt:DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments/{environmentId}

Erforderliche Berechtigungen: Environment.ReadWrite.All oder Item.ReadWrite.All

Weitere Informationen zur REST-API finden Sie unter Delete environment.

Zugehöriger Inhalt

• Spark Compute-Konfigurationseinstellungen in Fabric-Umgebungen
• Bibliotheksverwaltung in Fabric-Umgebungen