Κοινή χρήση μέσω

Items - Create KQL Database

  • Αναφορά
Υπηρεσία:
KQLDatabase
Έκδοση API:
v1

Δημιουργεί μια βάση δεδομένων KQL στον καθορισμένο χώρο εργασίας.
Αυτό το API υποστηρίζει λειτουργίες μεγάλης διάρκειας (LRO).

Δικαιώματα

Ο καλών πρέπει να έχει συνεισφέροντα ή μεγαλύτερο ρόλο χώρου εργασίας.

Απαιτούμενες εμβέλειες με ανάθεση

KQLDatabase.ReadWrite.All ή Item.ReadWrite.All

Περιορισμούς

  • Για να δημιουργήσετε μια βάση δεδομένων KQL, ο χώρος εργασίας πρέπει να βρίσκεται σε υποστηριζόμενους εκχωρημένους πόρους Fabric. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα: τύποι αδειών χρήσης Microsoft Fabric.

Υποστηριζόμενες ταυτότητες Microsoft Entra

Αυτό το API υποστηρίζει τις ταυτότητες Microsoft που παρατίθενται σε αυτή την ενότητα.

Ταυτότητα Υποστηρίζω
Χρήστης Ναι
Υπηρεσίας και διαχειριζόμενες ταυτότητες Ναι

Διεπαφή

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/kqlDatabases

Παράμετροι URI

Όνομα Σε Απαιτείται Τύπος Περιγραφή
workspaceId
 path True

string

uuid

Το αναγνωριστικό χώρου εργασίας.

Κυρίως τμήμα αίτησης

Όνομα Απαιτείται Τύπος Περιγραφή
displayName True

string

Το εμφανιζόμενο όνομα της βάσης δεδομένων KQL. Το όνομα της βάσης δεδομένων μπορεί να περιέχει αλφαριθμητικούς χαρακτήρες, χαρακτήρες υπογράμμισης, τελείες και ενωτικά. Δεν υποστηρίζονται ειδικοί χαρακτήρες.
creationPayload KQLDatabaseCreationPayload:

Το ωφέλιμο φορτίο δημιουργίας βάσης δεδομένων KQL. Χρησιμοποιήστε definition ή creationPayload. Δεν μπορείτε να χρησιμοποιήσετε και τα δύο ταυτόχρονα.
definition

KQLDatabaseDefinition

Ο δημόσιος ορισμός της βάσης δεδομένων KQL. Χρησιμοποιήστε creationPayload ή definition. Δεν μπορείτε να χρησιμοποιήσετε και τα δύο ταυτόχρονα.
description

string

Η περιγραφή της βάσης δεδομένων KQL. Το μέγιστο μήκος είναι 256 χαρακτήρες.

Αποκρίσεις

Όνομα Τύπος Περιγραφή
201 Created

KQLDatabase

Δημιουργήθηκε με επιτυχία
202 Accepted

Αίτηση αποδοχής, Παροχή βάσης δεδομένων KQL σε εξέλιξη

Κεφαλίδες

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Συνήθεις κωδικοί σφαλμάτων:

  • InvalidItemType - Ο τύπος στοιχείου δεν είναι έγκυρος

  • ItemDisplayNameAlreadyInUse - Το εμφανιζόμενο όνομα στοιχείου χρησιμοποιείται ήδη

  • CorruptedPayload - Το παρεχόμενο ωφέλιμο φορτίο είναι διεφθαρμένο.

Παραδείγματα

Create a ReadWrite KQL database example
Create a ReadWrite KQL database with definition example
Create a Shortcut KQL database to source Azure Data Explorer cluster example
Create a Shortcut KQL database to source Azure Data Explorer cluster with invitation token example
Create a Shortcut KQL database to source KQL database example

Create a ReadWrite KQL database example

Δείγμα αίτησης

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/kqlDatabases

{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "creationPayload": {
    "databaseType": "ReadWrite",
    "parentEventhouseItemId": "5b218778-e7a5-4d73-8187-f10824047836"
  }
}

Δείγμα απόκρισης

Κωδικός κατάστασης:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a ReadWrite KQL database with definition example

Δείγμα αίτησης

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/kqlDatabases

{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "definition": {
    "parts": [
      {
        "path": "DatabaseProperties.json",
        "payload": "ewogICJkYXRhYmFzZVR5cGUiOiAiUmVhZFdyaXRlIiwKICAicGFyZW50RXZlbnRob3VzZUl0ZW1JZCI6ICI1YjIxODc3OC1lN2E1LTRkNzMtODE4Ny1mMTA4MjQwNDc4MzYiLAogICJvbmVMYWtlQ2FjaGluZ1BlcmlvZCI6ICJQMzY1MDBEIiwKICAib25lTGFrZVN0YW5kYXJkU3RvcmFnZVBlcmlvZCI6ICJQMzY1MDBEIgp9",
        "payloadType": "InlineBase64"
      },
      {
        "path": "DatabaseSchema.kql",
        "payload": "Ly8gS1FMIHNjcmlwdAovLyBVc2UgbWFuYWdlbWVudCBjb21tYW5kcyBpbiB0aGlzIHNjcmlwdCB0byBjb25maWd1cmUgeW91ciBkYXRhYmFzZSBpdGVtcywgc3VjaCBhcyB0YWJsZXMsIGZ1bmN0aW9ucywgbWF0ZXJpYWxpemVkIHZpZXdzLCBhbmQgbW9yZS4KCi5jcmVhdGUtbWVyZ2UgdGFibGUgTXlMb2dzIChMZXZlbDpzdHJpbmcsIFRpbWVzdGFtcDpkYXRldGltZSwgVXNlcklkOnN0cmluZywgVHJhY2VJZDpzdHJpbmcsIE1lc3NhZ2U6c3RyaW5nLCBQcm9jZXNzSWQ6aW50KQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Δείγμα απόκρισης

Κωδικός κατάστασης:
201 
{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047651"
}
Κωδικός κατάστασης:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a Shortcut KQL database to source Azure Data Explorer cluster example

Δείγμα αίτησης

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/kqlDatabases

{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "creationPayload": {
    "databaseType": "Shortcut",
    "parentEventhouseItemId": "5b218778-e7a5-4d73-8187-f10824047836",
    "sourceClusterUri": "https://adxcluster.westus.kusto.windows.net",
    "sourceDatabaseName": "MyDatabase"
  }
}

Δείγμα απόκρισης

Κωδικός κατάστασης:
201 
{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047653"
}
Κωδικός κατάστασης:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a Shortcut KQL database to source Azure Data Explorer cluster with invitation token example

Δείγμα αίτησης

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/kqlDatabases

{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "creationPayload": {
    "databaseType": "Shortcut",
    "parentEventhouseItemId": "5b218778-e7a5-4d73-8187-f10824047836",
    "invitationToken": "eyJ0eXAiOiJKVInvitationToken"
  }
}

Δείγμα απόκρισης

Κωδικός κατάστασης:
201 
{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047654"
}
Κωδικός κατάστασης:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a Shortcut KQL database to source KQL database example

Δείγμα αίτησης

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/kqlDatabases

{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "creationPayload": {
    "databaseType": "Shortcut",
    "parentEventhouseItemId": "5b218778-e7a5-4d73-8187-f10824047836",
    "sourceDatabaseName": "ac542109-abd1-4ee3-aec5-86282c01ee24"
  }
}

Δείγμα απόκρισης

Κωδικός κατάστασης:
201 
{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047652"
}
Κωδικός κατάστασης:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Ορισμοί

Όνομα Περιγραφή
CreateKQLDatabaseRequest

Δημιουργήστε ωφέλιμο φορτίο αίτησης βάσης δεδομένων KQL.
ErrorRelatedResource

Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse

Η απόκριση σφάλματος.
ErrorResponseDetails

Οι λεπτομέρειες της απόκρισης σφάλματος.
ItemType

Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου.
KQLDatabase

Ένα αντικείμενο βάσης δεδομένων KQL.
KQLDatabaseDefinition

Αντικείμενο δημόσιου ορισμού βάσης δεδομένων KQL.
KQLDatabaseDefinitionPart

Αντικείμενο τμήματος ορισμού βάσης δεδομένων KQL.
KQLDatabaseProperties

Οι ιδιότητες βάσης δεδομένων KQL.
KqlDatabaseType

Ο τύπος της βάσης δεδομένων.
PayloadType

Ο τύπος του ωφέλιμου φορτίου τμήματος ορισμού. Επιπλέον τύποι ωφέλιμου φορτίου μπορούν να προστεθούν με την πάροδο του χρόνου.
ReadWriteDatabaseCreationPayload

Ωφέλιμο φορτίο δημιουργίας στοιχείων βάσης δεδομένων ReadWrite KQL
ShortcutDatabaseCreationPayload

Ωφέλιμο φορτίο δημιουργίας στοιχείου βάσης δεδομένων Shortcut KQL

CreateKQLDatabaseRequest

Object

Δημιουργήστε ωφέλιμο φορτίο αίτησης βάσης δεδομένων KQL.

Όνομα Τύπος Περιγραφή
creationPayload KQLDatabaseCreationPayload:

Το ωφέλιμο φορτίο δημιουργίας βάσης δεδομένων KQL. Χρησιμοποιήστε definition ή creationPayload. Δεν μπορείτε να χρησιμοποιήσετε και τα δύο ταυτόχρονα.
definition

KQLDatabaseDefinition

Ο δημόσιος ορισμός της βάσης δεδομένων KQL. Χρησιμοποιήστε creationPayload ή definition. Δεν μπορείτε να χρησιμοποιήσετε και τα δύο ταυτόχρονα.
description

string

Η περιγραφή της βάσης δεδομένων KQL. Το μέγιστο μήκος είναι 256 χαρακτήρες.
displayName

string

Το εμφανιζόμενο όνομα της βάσης δεδομένων KQL. Το όνομα της βάσης δεδομένων μπορεί να περιέχει αλφαριθμητικούς χαρακτήρες, χαρακτήρες υπογράμμισης, τελείες και ενωτικά. Δεν υποστηρίζονται ειδικοί χαρακτήρες.

ErrorRelatedResource

Object

Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.

Όνομα Τύπος Περιγραφή
resourceId

string

Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.
resourceType

string

Ο τύπος του πόρου που εμπλέκεται στο σφάλμα.

ErrorResponse

Object

Η απόκριση σφάλματος.

Όνομα Τύπος Περιγραφή
errorCode

string

Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message

string

Μια αναγνώσιμη αναπαράσταση του σφάλματος.
moreDetails

ErrorResponseDetails[]

Λίστα πρόσθετων λεπτομερειών σφάλματος.
relatedResource

ErrorRelatedResource

Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.
requestId

string

Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα.

ErrorResponseDetails

Object

Οι λεπτομέρειες της απόκρισης σφάλματος.

Όνομα Τύπος Περιγραφή
errorCode

string

Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message

string

Μια αναγνώσιμη αναπαράσταση του σφάλματος.
relatedResource

ErrorRelatedResource

Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

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

Object

Ένα αντικείμενο βάσης δεδομένων KQL.

Όνομα Τύπος Περιγραφή
description

string

Η περιγραφή του στοιχείου.
displayName

string

Το εμφανιζόμενο όνομα του στοιχείου.
id

string

uuid

Το αναγνωριστικό στοιχείου.
properties

KQLDatabaseProperties

Οι ιδιότητες βάσης δεδομένων KQL.
type

ItemType

Ο τύπος στοιχείου.
workspaceId

string

uuid

Το αναγνωριστικό χώρου εργασίας.

KQLDatabaseDefinition

Object

Αντικείμενο δημόσιου ορισμού βάσης δεδομένων KQL.

Όνομα Τύπος Περιγραφή
format

string

Η μορφή του ορισμού στοιχείου.
parts

KQLDatabaseDefinitionPart[]

Μια λίστα τμημάτων ορισμού.

KQLDatabaseDefinitionPart

Object

Αντικείμενο τμήματος ορισμού βάσης δεδομένων KQL.

Όνομα Τύπος Περιγραφή
path

string

Η διαδρομή τμήματος βάσης δεδομένων KQL.
payload

string

Το ωφέλιμο φορτίο τμήματος βάσης δεδομένων KQL.
payloadType

PayloadType

Ο τύπος ωφέλιμου φορτίου.

KQLDatabaseProperties

Object

Οι ιδιότητες βάσης δεδομένων KQL.

Όνομα Τύπος Περιγραφή
databaseType

KqlDatabaseType

Ο τύπος της βάσης δεδομένων.
ingestionServiceUri

string

URI υπηρεσίας πρόσληψης.
parentEventhouseItemId

string

Αναγνωριστικό γονικής υπηρεσίας συμβάντων.
queryServiceUri

string

URI υπηρεσίας ερωτημάτων.

KqlDatabaseType

Απαρίθμηση

Ο τύπος της βάσης δεδομένων.

Τιμή Περιγραφή
ReadWrite

Επιτρέπει λειτουργίες ανάγνωσης και εγγραφής στη βάση δεδομένων.
Shortcut

Μια συντόμευση είναι μια ενσωματωμένη αναφορά που επιτρέπει λειτουργίες μόνο για ανάγνωση σε μια βάση δεδομένων προέλευσης. Η προέλευση μπορεί να είναι στους ίδιους ή διαφορετικούς μισθωτές, είτε σε ένα σύμπλεγμα Azure Data Explorer είτε σε μια αποθήκη συμβάντων Fabric.

PayloadType

Απαρίθμηση

Ο τύπος του ωφέλιμου φορτίου τμήματος ορισμού. Επιπλέον τύποι ωφέλιμου φορτίου μπορούν να προστεθούν με την πάροδο του χρόνου.

Τιμή Περιγραφή
InlineBase64

Ενσωματωμένη βάση 64.

ReadWriteDatabaseCreationPayload

Object

Ωφέλιμο φορτίο δημιουργίας στοιχείων βάσης δεδομένων ReadWrite KQL

Όνομα Τύπος Περιγραφή
databaseType string:

ReadWrite

Ο τύπος της βάσης δεδομένων KQL
parentEventhouseItemId

string

uuid

Αναγνωριστικό στοιχείου γονικής υπηρεσίας συμβάντων.

ShortcutDatabaseCreationPayload

Object

Ωφέλιμο φορτίο δημιουργίας στοιχείου βάσης δεδομένων Shortcut KQL

Όνομα Τύπος Περιγραφή
databaseType string:

Shortcut

Ο τύπος της βάσης δεδομένων KQL
invitationToken

string

Διακριτικό πρόσκλησης για παρακολούθηση της βάσης δεδομένων προέλευσης
parentEventhouseItemId

string

uuid

Αναγνωριστικό στοιχείου γονικής υπηρεσίας συμβάντων.
sourceClusterUri

string

Το URI της προέλευσης Eventhouse ή του συμπλέγματος Azure Data Explorer
sourceDatabaseName

string

Το όνομα της βάσης δεδομένων που θα ακολουθήσει στο σύμπλεγμα προέλευσης Eventhouse ή Azure Data Explorer.