Items - Get KQL Database
Επιστρέφει ιδιότητες της καθορισμένης βάσης δεδομένων KQL.
Δικαιώματα
Ο καλών πρέπει να έχει ρόλο θεατή ή υψηλότερο ρόλο χώρου εργασίας.
Απαιτούμενες εμβέλειες με ανάθεση
KQLDatabase.Read.All ή KQLDatabase.ReadWrite.All ή Item.Read.All ή Item.ReadWrite.All
Υποστηριζόμενες ταυτότητες Microsoft Entra
Αυτό το API υποστηρίζει τις ταυτότητες Microsoft που παρατίθενται σε αυτή την ενότητα.
| Ταυτότητα | Υποστηρίζω |
|---|---|
| Χρήστης | Ναι |
| Υπηρεσίας και διαχειριζόμενες ταυτότητες | Ναι |
Διεπαφή
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/kqlDatabases/{kqlDatabaseId}Παράμετροι URI
| Όνομα | Σε | Απαιτείται | Τύπος | Περιγραφή |
|---|---|---|---|---|
|
kql
|
path | True |
string uuid |
Το αναγνωριστικό βάσης δεδομένων KQL. |
|
workspace
|
path | True |
string uuid |
Το αναγνωριστικό χώρου εργασίας. |
Αποκρίσεις
| Όνομα | Τύπος | Περιγραφή |
|---|---|---|
| 200 OK |
Η αίτηση ολοκληρώθηκε με επιτυχία. |
|
| Other Status Codes |
Συνήθεις κωδικοί σφαλμάτων:
|
Παραδείγματα
Get a KQL database example
Δείγμα αίτησης
GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/kqlDatabases/5b218778-e7a5-4d73-8187-f10824047715
Δείγμα απόκρισης
{
"displayName": "KQLDatabase_1",
"description": "A KQL database description.",
"type": "KQLDatabase",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715",
"properties": {
"parentEventhouseItemId": "6a437a7c-1a28-4fd0-a362-11308b94c79b",
"queryServiceUri": "https://trd-f7k1b2rzuqrjmb3wpd.z5.kusto.fabric.microsoft.com",
"ingestionServiceUri": "https://ingest-trd-f7k1b2rzuqrjmb3wpd.z5.kusto.fabric.microsoft.com",
"databaseType": "ReadWrite"
}
}Ορισμοί
| Όνομα | Περιγραφή |
|---|---|
|
Error |
Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα. |
|
Error |
Η απόκριση σφάλματος. |
|
Error |
Οι λεπτομέρειες της απόκρισης σφάλματος. |
|
Item |
Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου. |
| KQLDatabase |
Ένα αντικείμενο βάσης δεδομένων KQL. |
|
KQLDatabase |
Οι ιδιότητες βάσης δεδομένων KQL. |
|
Kql |
Ο τύπος της βάσης δεδομένων. |
ErrorRelatedResource
Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
| Όνομα | Τύπος | Περιγραφή |
|---|---|---|
| resourceId |
string |
Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα. |
| resourceType |
string |
Ο τύπος του πόρου που εμπλέκεται στο σφάλμα. |
ErrorResponse
Η απόκριση σφάλματος.
| Όνομα | Τύπος | Περιγραφή |
|---|---|---|
| errorCode |
string |
Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της. |
| message |
string |
Μια αναγνώσιμη αναπαράσταση του σφάλματος. |
| moreDetails |
Λίστα πρόσθετων λεπτομερειών σφάλματος. |
|
| relatedResource |
Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα. |
|
| requestId |
string |
Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα. |
ErrorResponseDetails
Οι λεπτομέρειες της απόκρισης σφάλματος.
| Όνομα | Τύπος | Περιγραφή |
|---|---|---|
| errorCode |
string |
Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της. |
| message |
string |
Μια αναγνώσιμη αναπαράσταση του σφάλματος. |
| relatedResource |
Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα. |
ItemType
Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου.
| Τιμή | Περιγραφή |
|---|---|
| Dashboard |
Πίνακας εργαλείων του PowerBI. |
| DataPipeline |
Μια διοχέτευση δεδομένων. |
| Datamart |
Datamart του PowerBI. |
| Environment |
Ένα περιβάλλον. |
| Eventhouse |
Μια εκδήλωση. |
| Eventstream |
Μια ροή συμβάντος. |
| GraphQLApi |
Ένα API για το στοιχείο GraphQL. |
| KQLDashboard |
Ένας πίνακας εργαλείων KQL. |
| KQLDatabase |
Μια βάση δεδομένων KQL. |
| KQLQueryset |
Ένα σύνολο ερωτημάτων KQL. |
| Lakehouse |
Ένα λιμνοθάσπιτο. |
| MLExperiment |
Ένα πείραμα εκμάθησης μηχανής. |
| MLModel |
Ένα μοντέλο εκμάθησης μηχανής. |
| MirroredDatabase |
Μια βάση δεδομένων κατοπτρισμού. |
| MirroredWarehouse |
Μια αποθήκη με κατοπτρικό καθρέφτη. |
| MountedDataFactory |
A MountedDataFactory. |
| Notebook |
Ένα σημειωματάριο. |
| PaginatedReport |
Σελιδοποιημένη αναφορά PowerBI. |
| Reflex |
Αντανακλαστικά. |
| Report |
Αναφορά PowerBI. |
| SQLDatabase |
Μια βάση δεδομένων SQL. |
| SQLEndpoint |
Ένα τελικό σημείο SQL. |
| SemanticModel |
Σημασιολογικό μοντέλο PowerBI. |
| SparkJobDefinition |
Ένας ορισμός εργασίας σπινθήρα. |
| Warehouse |
Μια αποθήκη. |
KQLDatabase
Ένα αντικείμενο βάσης δεδομένων KQL.
| Όνομα | Τύπος | Περιγραφή |
|---|---|---|
| description |
string |
Η περιγραφή του στοιχείου. |
| displayName |
string |
Το εμφανιζόμενο όνομα του στοιχείου. |
| id |
string uuid |
Το αναγνωριστικό στοιχείου. |
| properties |
Οι ιδιότητες βάσης δεδομένων KQL. |
|
| type |
Ο τύπος στοιχείου. |
|
| workspaceId |
string uuid |
Το αναγνωριστικό χώρου εργασίας. |
KQLDatabaseProperties
Οι ιδιότητες βάσης δεδομένων KQL.
| Όνομα | Τύπος | Περιγραφή |
|---|---|---|
| databaseType |
Ο τύπος της βάσης δεδομένων. |
|
| ingestionServiceUri |
string |
URI υπηρεσίας πρόσληψης. |
| parentEventhouseItemId |
string |
Αναγνωριστικό γονικής υπηρεσίας συμβάντων. |
| queryServiceUri |
string |
URI υπηρεσίας ερωτημάτων. |
KqlDatabaseType
Ο τύπος της βάσης δεδομένων.
| Τιμή | Περιγραφή |
|---|---|
| ReadWrite |
Επιτρέπει λειτουργίες ανάγνωσης και εγγραφής στη βάση δεδομένων. |
| Shortcut |
Μια συντόμευση είναι μια ενσωματωμένη αναφορά που επιτρέπει λειτουργίες μόνο για ανάγνωση σε μια βάση δεδομένων προέλευσης. Η προέλευση μπορεί να είναι στους ίδιους ή διαφορετικούς μισθωτές, είτε σε ένα σύμπλεγμα Azure Data Explorer είτε σε μια αποθήκη συμβάντων Fabric. |