Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Meer informatie over hoe Git-integratie- en implementatiepijplijnen werken met API voor GraphQL in Microsoft Fabric. Dit artikel helpt u inzicht te hebben in het instellen van een verbinding met uw opslagplaats, het beheren van uw API voor GraphQL en het implementeren ervan in verschillende omgevingen.
Opmerking
API voor GraphQL-broncodebeheer en -implementatie is momenteel beschikbaar als preview-versie.
Vereiste voorwaarden
- U moet een API voor GraphQL in Fabric hebben. Zie Een API maken voor GraphQL in Fabric en gegevens toevoegenvoor meer informatie.
Overzicht
Fabric biedt krachtige hulpprogramma's voor CI/CD (continue integratie en continue implementatie) en ontwikkelingslevenscyclusbeheer via twee hoofdonderdelen: Git-integratie (CI) en implementatiepijplijnen (CD). Werkruimten fungeren als centrale onderdelen voor zowel Git-synchronisatie- als implementatiefasen.
Git-integratie (CI): synchroniseert werkruimte-items (bijvoorbeeld code, configuraties, API's) met opslagplaatsen voor versiebeheer, waardoor versiebeheer en wijzigingen bijhouden via Git mogelijk zijn.
Implementatiepijplijnen (CD): hiermee kunt u fasen maken (bijvoorbeeld Ontwikkeling, Testen, Productie) met gekoppelde werkruimten. Items die in elke fase worden ondersteund, worden automatisch gerepliceerd naar de daaropvolgende fasen, en wijzigingen in een werkruimte activeren de implementatie in een releasepijplijn. U kunt de pijplijn configureren om ervoor te zorgen dat wijzigingen efficiënt worden getest en geïmplementeerd in omgevingen.
Fabric ondersteunt verschillende CI/CD-werkstromen die zijn afgestemd op algemene scenario's. Zie CI/CD-werkstroomopties in Fabric voor meer informatie.
Opmerking
Alleen metagegevens worden gekopieerd tijdens de implementatie; en gegevens worden niet gekopieerd.
Items uit de werkruimte worden opgeslagen in de bijbehorende Git-opslagplaats als Infrastructure as Code (IaC). Codewijzigingen in de opslagplaats kunnen de implementatie in pijplijnen activeren. Met deze methode kunt u codewijzigingen automatisch laten repliceren in fasen voor test- en productiereleasedoeleinden.
Verificatiemethoden voor gegevensbronnen
In deze sectie leert u meer over verificatiemethoden om gegevensbronnen te verbinden met uw API voor GraphQL en inzicht te krijgen in hun invloed op automatisch verbinden tussen de API voor GraphQL en de bijbehorende verbonden gegevensbronnen in ontwikkelingspijplijnen. Meer informatie over automatisch verbinden vindt u in het implementatiepijplijnproces.
Er zijn twee opties beschikbaar om gegevensbronnen te verbinden met uw API voor GraphQL:
Verbinding maken met Fabric-gegevensbronnen met eenmalige aanmelding (SSO)
Verbinding maken met Fabric OF externe gegevensbronnen met behulp van een opgeslagen referentie
Met de eerste optie, Single Sign-On (SSO), worden verbindingen met gegevensbronnen binnen Fabric mogelijk. Wanneer u in dit geval een gegevensbron verbindt met GraphQL met behulp van een methode voor eenmalige aanmelding in de oorspronkelijke werkruimte (bijvoorbeeld Dev-fase), worden de gegevensbron en het GraphQL-item geïmplementeerd in de doelwerkruimte (bijvoorbeeld testfase) in de pijplijn en wordt GraphQL in de doelwerkruimte automatisch verbonden met de geïmplementeerde lokale gegevensbron in de doelwerkruimte (zie het onderstaande diagram). Er zijn specifieke beperkingen bij het gebruik van eenmalige aanmelding en het maken van verbinding met een gegevensbron via SQL Analytics-eindpunt. Zie **Huidige beperkingen voor meer informatie.
Met de tweede optie, Opgeslagen referentie, kunt u verbindingen met externe gegevensbronnen buiten Fabric en gegevensbronnen in Fabric inschakelen. Automatisch binden wordt echter niet ondersteund voor de benadering van opgeslagen referenties. Dit betekent dat als u een gegevensbron verbindt met GraphQL met behulp van opgeslagen referentie in de oorspronkelijke werkruimte (Dev-fase), de gegevensbron wordt geïmplementeerd in de doelwerkruimte (testfase) in de pijplijn. Het GraphQL-item in de doelwerkruimte blijft echter verbonden met de gegevensbron in de oorspronkelijke werkruimte (Dev-fase) via de opgeslagen referenties, in plaats van automatisch te koppelen aan een lokale gegevensbron in de doelwerkruimte. (zie het onderstaande diagram)
Als de methode Opgeslagen referentie wordt gebruikt om verbinding te maken met gegevensbronnen, moeten ontwikkelaars bovendien toegang hebben tot de opgeslagen referentiegegevens om GraphQL-item te kunnen implementeren.
Opmerking
Als een API voor GraphQL in de oorspronkelijke werkruimte (Dev-fase) is verbonden met een gegevensbron die zich in een andere werkruimte bevindt, blijft de geïmplementeerde API voor GraphQL in de doelwerkruimte (testfase) verbonden met de gegevensbron die zich in een andere werkruimte bevindt, ongeacht welke verificatiemethode wordt gebruikt om de gegevensbronnen te verbinden met uw API voor GraphQL. (zie het onderstaande diagram)
API voor GraphQL Git-integratie
Fabric-API voor GraphQL biedt Git-integratie voor broncodebeheer. Met Git-integratie kunt u een back-up maken van uw API voor GraphQL, zo nodig terugkeren naar eerdere fasen, samenwerken of alleen werken met behulp van Git-vertakkingen en uw API voor GraphQL-levenscyclus volledig beheren binnen Fabric.
Een verbinding instellen:
Vanuit uw werkruimte-instellingen kunt u eenvoudig een verbinding met uw opslagplaats instellen om wijzigingen door te voeren en te synchroniseren. Zie Aan de slag met Git-integratie om de verbinding in te stellen. Zodra u verbonden bent, worden uw items, inclusief de API voor GraphQL, weergegeven in het Bronbeheerpaneel.
Nadat u de API voor GraphQL-instanties hebt gecommit in de Git-repository, ziet u de GraphQL-mapstructuur in de repository. U kunt nu toekomstige bewerkingen uitvoeren, zoals pull-aanvraag maken.
GraphQL-weergave in Git:
De volgende afbeelding is een voorbeeld van de bestandsstructuur van elke API voor GraphQL-item in de Git-opslagplaats:
Wanneer u de API voor GraphQL-item doorvoert in de Git-opslagplaats, wordt de API voor GraphQL-definitie opgeslagen. Deze aanpak ondersteunt een nauwkeurig herstel wanneer u terug synchroniseert met een Fabric-werkruimte:
Meer informatie over de GraphQL API-definitie-indeling, syntaxis en voorbeelden vindt u in de documentatie over api's voor het fabric-besturingsvlak:
API voor GraphQL in implementatiepijplijn
Gebruik de volgende stappen om uw API voor GraphQL-implementatie te voltooien met behulp van de implementatiepijplijn.
Maak een nieuwe implementatiepijplijn of open een bestaande implementatiepijplijn. Zie Aan de slag met implementatiepijplijnen voor meer informatie.
Wijs werkruimten toe aan verschillende fasen op basis van uw implementatiedoelen.
Items selecteren, weergeven en vergelijken, waaronder API voor GraphQL tussen verschillende fasen, zoals wordt weergegeven in het volgende voorbeeld. De gemarkeerde gebieden die het aantal gewijzigde items aangeven tussen de vorige fase en de huidige fase.
- Selecteer de items die moeten worden geïmplementeerd. Selecteer Implementeren om de geselecteerde items (API voor GraphQL en de bijbehorende verbonden gegevensbron) te implementeren in de fasen Ontwikkeling, Test en Productie.
Het volgende bericht wordt weergegeven om de items te bevestigen die u gaat implementeren. Selecteer Implementeren om te bevestigen en door te gaan met het implementatieproces.
Huidige beperkingen
Fabric CI/CD biedt geen ondersteuning voor automatische koppeling van de onderliggende items. Dit betekent dat als de API voor GraphQL verbinding maakt met een SQL Analytics-eindpunt als onderliggend element van een gegevensbron in de oorspronkelijke werkruimte (bijvoorbeeld ontwikkelingsfase), de lijn niet wordt overgedragen naar de doelwerkruimte (bijvoorbeeld testfase). Als gevolg hiervan blijft de geïmplementeerde API voor GraphQL in de doelwerkruimte (bijvoorbeeld testfase) verbonden met het SQL Analytics-eindpunt in de oorspronkelijke werkruimte (bijvoorbeeld dev-fase).
Automatisch verbinden wordt niet ondersteund wanneer de opgeslagen referentiebenadering wordt gebruikt voor gegevensbronverbindingen. Zie de sectie verificatiemethoden voor gegevensbronnen die hierboven worden beschreven voor meer informatie.