Share via

Bibliotheekbeheer in Fabric-omgevingen

Microsoft Fabric-omgevingen bieden flexibele configuraties voor het uitvoeren van uw Spark-taken. Bibliotheken bieden herbruikbare code die ontwikkelaars in hun werk willen opnemen. Behalve de ingebouwde bibliotheken die bij elke Spark-runtime worden geleverd, kunt u openbare en aangepaste bibliotheken installeren in uw Fabric-omgevingen. U kunt eenvoudig omgevingen koppelen aan uw notebooks en Spark-taakdefinities.

Notitie

Navigeer naar de werkruimte waar uw omgeving zich bevindt, selecteer de opties voor omgevings - en bibliotheekbeheer op het tabblad Bibliotheken. Als u geen omgeving hebt gemaakt, raadpleegt u Een omgeving maken, configureren en gebruiken in Fabric.

Ingebouwde bibliotheken

In Fabric wordt elke runtimeversie vooraf geladen met een gecureerde set ingebouwde bibliotheken die zijn geoptimaliseerd voor prestaties, compatibiliteit en beveiliging in Python, R, Java en Scala. Met de sectie Ingebouwde bibliotheken in de omgeving kunt u door deze vooraf geïnstalleerde bibliotheken bladeren en zoeken op basis van de geselecteerde runtime.

Als u de lijst met vooraf geïnstalleerde pakketten en hun versies voor elke runtime wilt weergeven, raadpleegt u Apache Spark-runtimes in Fabric.

Belangrijk

Fabric ondersteunt verschillende manieren om pakketten te beheren. Zie voor meer opties en aanbevolen procedures voor het beheren van bibliotheken in Fabric, Apache Spark-bibliotheken beheren in Fabric. Wanneer uw werkruimte netwerkfuncties heeft zoals uitgaande toegangsbeveiliging voor werkruimten of beheerde VNets, wordt de toegang tot openbare opslagplaatsen zoals PyPI geblokkeerd. Volg de instructies in Bibliotheken beheren met beperkte netwerktoegang in Fabric om de bibliotheken in omgeving naadloos te beheren.

Externe opslagplaatsen

In de sectie Externe opslagplaatsen kunt u bibliotheken toevoegen uit openbare bibliotheken, zoals PyPI en Conda, en ook vanuit uw privéopslagplaatsen, zoals Azure Artifact Feed.

Notitie

Het installeren van bibliotheken vanuit Azure Artifact Feed wordt momenteel ondersteund in Spark 3.5 en wordt niet ondersteund in werkruimten met privékoppeling of uitgaande toegangsbeveiliging.

Schermopname die het scherm Externe opslagplaatsen Bibliotheken van de omgeving toont.

Een nieuwe bibliotheek toevoegen vanuit openbare opslagplaatsen

Als u een nieuwe bibliotheek wilt toevoegen vanuit een openbare opslagplaats, bijvoorbeeld PyPI of conda, selecteert u Bibliotheek toevoegen uit openbare opslagplaats. Voer de naam van de bibliotheek in het zoekvak in. Terwijl u typt, worden populaire bibliotheken voorgesteld in het zoekvak, maar de lijst is beperkt. Als u de bibliotheek niet ziet, voert u de volledige naam in.

  • Als de naam van de bibliotheek geldig is, ziet u de beschikbare versies.
  • Als de bibliotheeknaam niet geldig is, krijgt u een waarschuwing dat de bibliotheek niet bestaat.

Een nieuwe bibliotheek toevoegen vanuit privéopslagplaatsen

Verbinding instellen voor uw Azure Artifact-feed

In Fabric is het rechtstreeks opslaan van de referentie verboden. De verbindingen moeten worden ingesteld in Data Factory Connector. Hieronder vindt u stapsgewijze instructies voor het instellen van de verbinding voor Azure Artifact Feed. Meer informatie over Azure Artifact Feed.

  1. Stap 1: Ga in uw werkruimte-instellingen naar Verbindingen en gateways beheren.

    Schermopname van het toegangspunt van de connectors voor externe opslagplaatsen van de omgeving.

  2. Stap 2: Maak een nieuwe verbinding. Selecteer Cloud als het type en kies Azure Artifact Feed (preview) als verbindingstype. Voer de URL en het gebruikerstoken in de respectieve velden in en zorg ervoor dat u Code-First artefact toestaat om toegang te krijgen tot deze verbinding (Preview).

    Schermopname van een voorbeeld van het maken van een nieuw connectorscherm.

  3. Stap 3: Noteer de verbindings-id na het maken. Dit is nodig voor het gebruik van de verbinding in Fabric-omgevingen.

Bibliotheken toevoegen vanuit De Azure Artifact-feed

Als u bibliotheken wilt installeren vanuit uw Azure Artifact-feed, bereidt u een YML-bestand voor met de juiste bibliotheekgegevens en verbindingsgegevens voor de privéopslagplaats. Een typisch YML-bestand bevat de URL en verificatiegegevens van de Azure Artifact-feed. Voor een correcte herkenning van de verbinding moet u de URL en referenties echter vervangen door de Connection ID die is gemaakt in Data Factory Connector.

Hieronder ziet u een voorbeeld:

# Regular YAML
dependencies:
  - pip:
    - fuzzywuzzy==0.18.0
    - wordcloud==1.9.4
    - --index-url <URL_TO_THE_AZURE_ARTIFACT_FEED_WITH_AUTH>

# Replace the Azure Artifact Feed URL with connection ID
dependencies:
  - pip:
    - fuzzywuzzy==0.18.0
    - wordcloud==1.9.4
    - --index-url <YOUR_CONNECTION_ID>

Met het voorbereide YML-bestand kunt u het rechtstreeks uploaden of overschakelen naar de YML-editorweergave om de inhoud in de editor in Fabric-omgevingen te plakken. Wanneer u de omgeving publiceert, leest het systeem de pakketten uit uw privéopslagplaats en bewaart deze in Fabric. Als u pakketten in uw Azure Artifact-feed bijwerkt, moet u de omgeving opnieuw publiceren om de meest recente wijzigingen toe te passen.

Notitie

  • In de lijstweergave kunt u alleen bibliotheken toevoegen of verwijderen of bewerken uit bestaande privéopslagplaatsen. Als u een privéopslagplaatsverbinding wilt toevoegen, verwijderen of bewerken, schakelt u over naar de YML-editorweergave en werkt u het YML-bestand rechtstreeks bij.
  • Het doorzoeken van bibliotheken in privéopslagplaatsen terwijl u typt, wordt momenteel niet ondersteund. Zorg ervoor dat u de naam en versie van de bibliotheek nauwkeurig invoert bij het toevoegen van bibliotheken uit privéopslagplaatsen. Onjuiste pakketgegevens kunnen ertoe leiden dat het publiceren van de omgeving mislukt.
  • U kunt meerdere opslagplaatsen opgeven in het YML-bestand. Bij het installeren van bibliotheken zoekt Fabric deze in de volgorde die wordt vermeld totdat het pakket is gevonden. Openbare opslagplaatsen, zoals PyPI en Conda, worden automatisch doorzocht, zelfs als ze niet zijn opgenomen in het YML-bestand.

Externe bibliotheken filteren

U kunt de pakketnaam als trefwoord gebruiken om de lijst met externe bibliotheken te filteren.

Externe bibliotheken bijwerken

U kunt de bibliotheeknaam, versie en brontype bijwerken in de lijstweergave. In de YML-editorweergave kunt u deze details ook bijwerken, samen met de verbindings-id van de Azure Artifact Feed.

Externe bibliotheken verwijderen

De optie Verwijderen voor elke bibliotheek wordt weergegeven wanneer u de muisaanwijzer boven de rij houdt. Als u meerdere externe bibliotheken wilt verwijderen, selecteert u deze en klikt u op Verwijderen. U kunt bibliotheken ook verwijderen met behulp van de YML-editorweergave.

Afhankelijkheid weergeven

Elke externe bibliotheek uit openbare opslagplaatsen kan afhankelijkheden hebben. De optie Afhankelijkheden weergeven wordt weergegeven wanneer u de muisaanwijzer boven de bijbehorende rij beweegt. Als u op deze knop klikt, wordt de afhankelijkheidsstructuur opgehaald uit openbare opslagplaatsen. Als de bibliotheek niet kan worden gevonden in openbare opslagplaatsen, bijvoorbeeld een persoonlijke bibliotheek in uw Azure Artifact Feed, is de afhankelijkheidsinformatie niet beschikbaar.

Exporteren naar .yml

Fabric biedt de mogelijkheid om de volledige lijst met externe bibliotheken te exporteren naar een .yml bestand en deze te downloaden naar uw lokale map.

Aangepaste bibliotheken

Aangepaste bibliotheken verwijzen naar code die door u of uw organisatie is gebouwd. Fabric ondersteunt aangepaste bibliotheekbestanden in .whl, .pyen .jar.tar.gz indelingen.

Notitie

Fabric ondersteunt alleen .tar.gz bestanden voor R-taal. Gebruik de .whl en .py bestandsindeling voor de Python-taal.

Schermopname van het Aangepaste Bibliotheken-scherm van de omgeving.

De aangepaste bibliotheek uploaden

U kunt aangepaste bibliotheken vanuit uw lokale map uploaden naar de Fabric-omgeving.

De aangepaste bibliotheek verwijderen

De prullenbakoptie voor elke bibliotheek wordt weergegeven wanneer u de muisaanwijzer boven de bijbehorende rij beweegt. Als u meerdere aangepaste bibliotheken wilt verwijderen, selecteert u deze en selecteert u Vervolgens Verwijderen.

Alle aangepaste bibliotheken downloaden

Selecteer aangepaste bibliotheken om ze één voor één te downloaden naar uw lokale standaard downloadmap.

Gerelateerde inhoud

  • Last updated on