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
- Umfangreiche Tools – Ermöglicht die Verwendung einer breiten Palette von Entwicklertools.
Es ist eine effizientere Möglichkeit für Anwendungen, mit Servern und Datenbanken zu kommunizieren.
Was ist die Microsoft Fabric-API für GraphQL?
Die 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
- Gespiegelte Microsoft Fabric-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.
Benötigt die API für die GraphQL-Clientanwendung Zugriff auf die Datenquelle, um Abfragen oder Mutationen auszuführen?
Microsoft Entra ID-Authentifizierung: DIE API für GraphQL erfordert, dass Anwendungen die 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-Dienst. Weitere Informationen finden Sie unter Erstellen einer Microsoft Entra-App in Azure.
SSO-Konfiguration (Single Sign-On): Wenn die API für die Verwendung von SSO konfiguriert ist, benötigt der authentifizierte Benutzer oder Dienstprinzipal Zugriff auf beide:
- Die GraphQL-API (Berechtigung "Abfragen und Mutationen ausführen ")
- Die Datenquelle (Lese- oder Schreibzugriff nach Bedarf)
Zugriffsoption auf Arbeitsbereichsebene: Alternativ können Sie den Benutzer oder dienstprinzipal als Arbeitsbereichsmitglied mit einer Mitwirkendenrolle zuweisen, in der sich sowohl die API- als auch die Datenquellenelemente befinden. Dies ermöglicht den erforderlichen Zugriff auf beide Elemente von einem einzigen Ort aus. Weitere Informationen finden Sie unter Gewähren des Zugriffs auf Arbeitsbereiche für Benutzer.
Konfiguration gespeicherter Anmeldeinformationen: Wenn die API für die Verwendung gespeicherter Anmeldeinformationen konfiguriert ist, benötigt der authentifizierte Benutzer oder Dienstprinzipal nur Zugriff auf die API (wählen Sie die Option "Abfragen und Mutationen ausführen " aus, wenn Sie der API direkte Zugriffsberechtigungen hinzufügen).
Beispiele: Sie finden ein End-to-End-Beispiel mit Beispielcode für Benutzerprinzipale und Dienstprinzipale bei Connect Applications.
Wie eröffne ich ein Supportticket für API for GraphQL?
Wenn du Hilfe von Microsoft-Support zu allen Themen im Zusammenhang mit der Fabric-API für GraphQL erhalten möchtest, besuche bitte unsere Fabric-Supportwebsite und wähle die Option Datentechnik aus.
Unterstützt die API für GraphQL private Verknüpfungen?
Die API für GraphQL unterstützt derzeit keinen privaten Link.
Warum führt meine Anforderung bei der ersten Ausgabe schlecht aus, und führen Sie dann 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.