Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
Få mere at vide om, hvordan Git-integrations- og udrulningspipelines fungerer sammen med API til GraphQL i Microsoft Fabric. Denne artikel hjælper dig med at forstå, hvordan du konfigurerer en forbindelse til dit lager, administrerer din API til GraphQL og udruller dem på tværs af forskellige miljøer.
Seddel
API til GraphQL-kildestyring og -installation er i øjeblikket en prøveversion.
Forudsætninger
- Du skal have en API til GraphQL i Fabric. Du kan få flere oplysninger i Opret en API til GraphQL i Fabric og tilføje data.
Oversigt
Fabric tilbyder effektive værktøjer til CI/CD (kontinuerlig integration og kontinuerlig udrulning) og administration af udviklingslivscyklus via to hovedkomponenter: Git-integration (CI) og udrulningspipelines (CD). Arbejdsområder fungerer som centrale komponenter til både Git-synkroniserings- og udrulningsfaser.
Git-integration (CI): Synkroniserer elementer i arbejdsområdet (f.eks. kode, konfigurationer, API'er) med versionsstyringslagre, aktivering af versionsstyring og ændringssporing via Git.
Udrulningspipelines (CD): Gør det muligt at oprette faser (f.eks. udvikling, test og produktion) med sammenkædede arbejdsområder. Elementer, der understøttes i hver fase, replikeres automatisk til efterfølgende faser, og ændringer i et arbejdsområde udløser udrulning i en udgivelsespipeline. Du kan konfigurere pipelinen for at sikre, at ændringer testes og udrulles effektivt på tværs af miljøer.
Fabric understøtter forskellige CI/CD-arbejdsprocesser, der er skræddersyet til almindelige scenarier. Du kan finde flere oplysninger under Indstillinger for CI/CD-arbejdsproces i Fabric.
Seddel
Det er kun metadata, der kopieres under installationen. og data kopieres ikke.
Elementer fra arbejdsområdet gemmes i det tilknyttede Git-lager som Infrastruktur som kode (IaC). Kodeændringer i lageret kan udløse udrulningen i pipelines. Denne metode giver dig mulighed for automatisk at replikere kodeændringer på tværs af faser til test- og produktionsudgivelsesformål.
Godkendelsesmetoder for datakilde
I dette afsnit får du mere at vide om godkendelsesmetoder til at forbinde datakilder til din API til GraphQL og forstå deres indvirkning på autobinding mellem API'en for GraphQL og dens forbundne datakilder i udviklingspipelines. Du kan få mere at vide om autobinding i udrulningspipelineprocessen.
Der er to muligheder for at forbinde datakilder til din API til GraphQL:
Opret forbindelse til Fabric-datakilder med enkeltlogongodkendelse (SSO)
Opret forbindelse til Fabric ELLER eksterne datakilder ved hjælp af gemte legitimationsoplysninger
Den første indstilling, Enkelt Sign-On (SSO), muliggør forbindelser til datakilder i Fabric. Når du i dette tilfælde opretter forbindelse mellem en datakilde og GraphQL ved hjælp af metoden Enkeltlogon i det oprindelige arbejdsområde (f.eks. udviklingsfasen), udrulles datakilden og GraphQL-elementet til målarbejdsområdet (f.eks. testfase) i pipelinen, og GraphQL i målarbejdsområdet forbindes automatisk med den installerede lokale datakilde i målarbejdsområdet (se nedenstående diagram). Der er specifikke begrænsninger, når du bruger SSO og opretter forbindelse til en datakilde via SQL Analytics-slutpunkt, for at få flere oplysninger henvises til **Aktuelle begrænsninger.
Den anden indstilling, Gemte legitimationsoplysninger, muliggør forbindelser til eksterne datakilder uden for Fabric og datakilder i Fabric. Autobinding understøttes dog ikke for metoden Gemte legitimationsoplysninger. Det betyder, at hvis du opretter forbindelse mellem en datakilde og GraphQL ved hjælp af Gemte legitimationsoplysninger i det oprindelige arbejdsområde (udviklingsfasen), installeres datakilden i målarbejdsområdet (testfasen) i pipelinen. GraphQL-elementet i målarbejdsområdet forbliver dog forbundet med datakilden i det oprindelige arbejdsområde (udviklingsfasen) via gemte legitimationsoplysninger i stedet for automatisk binding til en lokal datakilde i målarbejdsområdet. (se diagrammet nedenfor)
Hvis metoden Saved Credential bruges til at oprette forbindelse til datakilder, skal udviklere desuden have adgang til oplysningerne om gemte legitimationsoplysninger for at kunne installere GraphQL-elementet.
Seddel
Hvis en API til GraphQL i det oprindelige arbejdsområde (udviklingsfasen) er forbundet til en datakilde, der findes i et andet arbejdsområde, forbliver den udrullede API til GraphQL i målarbejdsområdet (testfase) forbundet med den datakilde, der er placeret i et andet arbejdsområde, uanset hvilken godkendelsesmetode der bruges til at forbinde datakilderne til din API til GraphQL. (se diagrammet nedenfor)
API til GraphQL Git-integration
Fabric API til GraphQL tilbyder Git-integration til kildestyring. Med Git-integration kan du sikkerhedskopiere og versionere din API til GraphQL, vende tilbage til tidligere faser efter behov, samarbejde eller arbejde alene ved hjælp af Git-forgreninger og administrere din API til GraphQL-livscyklus helt i Fabric.
Konfigurer en forbindelse:
Fra indstillingerne for arbejdsområdet kan du nemt konfigurere en forbindelse til dit lager for at bekræfte og synkronisere ændringer. Hvis du vil konfigurere forbindelsen, skal du se Kom i gang med Git-integration. Når du har oprettet forbindelse, vises dine elementer, herunder API til GraphQL, i kontrolpanelet Kilde .
Når du har bekræftet API'en for GraphQL-forekomster til Git-lageret, kan du se mappestrukturen GraphQL i lageret. Du kan nu udføre fremtidige handlinger, f.eks . Opret pullanmodning.
GraphQL-repræsentation i Git:
Følgende billede er et eksempel på filstrukturen for hvert API for GraphQL-element i Git-lageret:
Når du sender API'en for GraphQL-elementet til Git-lageret, gemmes API'en til GraphQL-definitionen. Denne fremgangsmåde understøtter en præcis genoprettelse, når du synkroniserer tilbage til et Fabric-arbejdsområde:
Du kan finde flere oplysninger om GraphQL API-definitionsformatet, syntaksen og eksemplerne i dokumentationen til API'er til Fabric-kontrolplanet:
API til GraphQL i udrulningspipeline
Brug følgende trin til at fuldføre din API til GraphQL-udrulning ved hjælp af udrulningspipelinen.
Opret en ny udrulningspipeline, eller åbn en eksisterende udrulningspipeline. Du kan få flere oplysninger under Kom i gang med udrulningspipelines.
Tildel arbejdsområder til forskellige faser i henhold til dine udrulningsmål.
Vælg, få vist og sammenlign elementer, herunder API for GraphQL mellem forskellige faser, som vist i følgende eksempel. De fremhævede områder, der angiver antallet af ændrede elementer mellem den forrige fase og den aktuelle fase.
- Vælg de elementer, der skal installeres. Vælg Udrul for at udrulle de valgte elementer (API til GraphQL og dens forbundne datakilde) på tværs af faserne Udvikling, Test og Produktion.
Den næste meddelelse vises, der bekræfter de elementer, du er ved at installere. Vælg Installér for at bekræfte og fortsætte installationsprocessen.
Aktuelle begrænsninger
Fabric CI/CD understøtter ikke automatisk binding af de underordnede elementer. Det betyder, at hvis API'en til GraphQL opretter forbindelse til et SQL Analytics-slutpunkt som underordnet til en datakilde i det oprindelige arbejdsområde (f.eks. udviklingsfasen), overføres afstamningen ikke til målarbejdsområdet (f.eks. testfasen). Derfor forbliver den udrullede API til GraphQL i målarbejdsområdet (f.eks. testfase) forbundet med SQL Analytics-slutpunktet i det oprindelige arbejdsområde (f.eks. udviklingsfase).
Autobinding understøttes ikke, når metoden Gemte legitimationsoplysninger bruges til datakildeforbindelser. Du kan få flere oplysninger i afsnittet Godkendelsesmetoder for datakilder , der er beskrevet ovenfor.