Hier finden Sie Antworten auf häufig gestellte Fabric-API für GraphQL-Fragen.
Was ist GraphQL?
GraphQL ist eine Abfragesprache für APIs, mit der Apps genau die benötigten Daten anfordern können. Zu den wichtigsten Vorteilen gehören:
- Starkes Typsystem – Beschreibt die verfügbaren Daten eindeutig.
- Präzises Abrufen von Daten – Reduziert das Überholen, indem bestimmte Anforderungen zugelassen werden.
- Abwärtskompatibilität – Macht API-Updates einfacher, ohne vorhandenen Code zu unterbrechen
- Rich-Tools – Ermöglicht die Verwendung einer breiten Palette von developer tools
Es ist eine effizientere Möglichkeit für Anwendungen, mit Servern und Datenbanken zu kommunizieren.
Was ist Microsoft Fabric-API für GraphQL?
Microsoft Fabric-API für GraphQL ist ein verwalteter Dienst, mit dem Sie eine GraphQL-API in Sekunden erstellen können.
Unterstützte Datenquellen:
- Microsoft Fabric Data Warehouses
- Microsoft Fabric Lakehouses
- Microsoft Fabric gespiegelte Datenbanken
- Microsoft Fabric SQL-Datenbanken
- Azure SQL Datenbanken
Sie stellt eine einheitliche API-Ebene zum Abfragen und Mutieren von Daten aus diesen unterstützten Datenquellen bereit.
Welche GraphQL-Vorgänge werden in der Fabric-API für GraphQL unterstützt?
Derzeit werden nur GraphQL-Abfragen (Lesen) und Mutationen (Schreiben) unterstützt. Datenquellen, die über SQL Analytics-Endpunkte verfügbar gemacht werden, sind schreibgeschützt und unterstützen somit nur Abfragen. Für Data Warehouses muss ein Primärschlüssel definiert werden, damit Mutationen automatisch generiert werden.
Wie kann ich Resolver in der Fabric-API für GraphQL anzeigen und bearbeiten?
Resolver sind GraphQL-Komponenten, die Geschäftslogik zum Auflösen von Feldern in der API und zum Ausführen von Vorgängen mit Daten bereitstellen, die sich in den Datenquellen befinden.
Automatische Generierung: Fabric generiert automatisch Resolver, wenn Sie eine neue Datenquelle anfügen oder neue Objekte auswählen, die aus einer vorhandenen Datenquelle verfügbar gemacht werden sollen.
Anpassung: Derzeit ist es nicht möglich, Resolver direkt anzupassen. Für angepasste Geschäftslogik in der API für GraphQL können Sie eine gespeicherte Prozedur in der Datenquelle erstellen und in der GraphQL-API verfügbar machen.
Erfordert die API für die GraphQL-Clientanwendung access für die Datenquelle, um Abfragen oder Mutationen auszuführen?
Microsoft Entra ID authentication:-API für GraphQL erfordert, dass Anwendungen Microsoft Entra ID für die Authentifizierung verwenden. Ihre Clientanwendung muss registriert und konfiguriert werden, um API-Aufrufe für Fabric auszuführen.
Erforderliche Berechtigungen:
- Die in Microsoft Entra registrierte App erfordert GraphQLApi.Execute.All Berechtigungen für den Power BI service. Weitere Informationen finden Sie unter Create a Microsoft Entra app in Azure.
Single-Anmeldekonfiguration (SSO): Wenn die API für die Verwendung von SSO konfiguriert ist, wird der authentifizierte Benutzer oder der Dienstprinzipal access für beides angefordert:
- Die GraphQL-API (Berechtigung "Abfragen und Mutationen ausführen ")
- Die Datenquelle (access nach Bedarf lesen oder schreiben)
Workspace-level access option: Alternativ können Sie den Benutzer oder Dienstprinzipal als Arbeitsbereichsmitglied mit einer rolle contributor zuweisen, in der sich sowohl die API- als auch die Datenquellenelemente befinden. Dies gibt den erforderlichen access für beide Elemente an einer zentralen Stelle. Weitere Informationen finden Sie unter Give Users access für Arbeitsbereiche.
Saved credentials configuration: Wenn die API für die Verwendung gespeicherter Anmeldeinformationen konfiguriert ist, benötigt der authentifizierte Benutzer oder Dienstprinzipal nur access für die API (wählen Sie Run Queries and Mutations Option beim Hinzufügen von direkten access Berechtigungen zur API aus).
Beispiele: Sie finden ein End-to-End-Beispiel mit Beispielcode für Benutzerprinzipale und Dienstprinzipale bei Connect Applications.
How do I ein Supportticket für DIE API für GraphQL öffnen?
Um Hilfe von Microsoft Support zu allen Problemen im Zusammenhang mit der Fabric-API für GraphQL zu erhalten, besuchen Sie unsere Fabric-Supportwebsite und wählen Sie die Option Data Engineering aus.
Unterstützt DIE API für GraphQL Private Link?
Die API für GraphQL unterstützt derzeit nur Tenant Level Private Link.
Warum schneidet meine Anforderung beim ersten Mal schlecht ab, führt aber bei nachfolgenden Anforderungen gut aus?
Es gibt zwei Hauptgründe für dieses "Kaltstart"-Verhalten:
Aufwärmen der Datenquelle:
- Die erste Anforderung kann länger dauern, wenn eine Datenquelle aus einem kalten Zustand aufgewärmet werden muss.
- Auch wenn die Datenquelle nicht kalt ist, ist der Datenempfang möglicherweise nicht so effizient, wenn GraphQL zum ersten Mal eine Abfrage ausgibt, wenn die Datenquelle nicht über die erforderlichen Daten verfügt, die im Arbeitsspeicher geladen sind.
API-Endpunktinitialisierung:
- Die erste Anforderung an eine API für den GraphQL-Endpunkt kann länger dauern, da das System Ihr Schema und die Konfiguration laden muss.
- Nachfolgende Anforderungen sind schneller, da das System bereits aufgewärmet ist und bereit ist, Ihre Anforderungen zu erfüllen.
Weitere Informationen finden Sie in den bewährten Methoden zur Leistung.
Wie kann ich Feedback oder Vorschläge für die API für GraphQL bereitstellen?
Wir freuen uns über Ihr Feedback und Ihre Vorschläge! Sie können Feedback über Fabric Ideasgeben. Unser Team überwacht aktiv das Feedback und vorschläge, das über diese Plattform übermittelt wurde. Sie können uns auch über Microsoft Fabric Support für bestimmte Abfragen oder Bedenken kontaktieren.