Items - Create Lakehouse

Αναφορά

Υπηρεσία:: Lakehouse

Έκδοση API:: v1

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

Αυτό το API δεν υποστηρίζει τη δημιουργία ενός lakehouse με ορισμό.

Δικαιώματα

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

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

Lakehouse.ReadWrite.All ή Item.ReadWrite.All

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

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

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

Διεπαφή

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

Παράμετροι URI

Όνομα	Σε	Απαιτείται	Τύπος	Περιγραφή
workspaceId	path	True	string uuid	Το αναγνωριστικό χώρου εργασίας.

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

Όνομα	Απαιτείται	Τύπος	Περιγραφή
displayName	True	string	Το εμφανιζόμενο όνομα της λίμνης. Το εμφανιζόμενο όνομα πρέπει να ακολουθεί τους κανόνες ονομασίας σύμφωνα με τον τύπο στοιχείου.
creationPayload		LakehouseCreationPayload	Το ωφέλιμο φορτίο δημιουργίας του lakehouse.
description		string	Η περιγραφή του lakehouse. Το μέγιστο μήκος είναι 256 χαρακτήρες.

Αποκρίσεις

Όνομα	Τύπος	Περιγραφή
201 Created	Lakehouse	Δημιουργήθηκε με επιτυχία
202 Accepted		Αίτημα αποδοχής, παροχή lakehouse σε εξέλιξη. Κεφαλίδες Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: InvalidItemType - Ο τύπος στοιχείου δεν είναι έγκυρος ItemDisplayNameAlreadyInUse - Το εμφανιζόμενο όνομα στοιχείου χρησιμοποιείται ήδη. CorruptedPayload - Το παρεχόμενο ωφέλιμο φορτίο είναι διεφθαρμένο.

Όνομα

Τύπος

Περιγραφή

201 Created

Lakehouse

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

202 Accepted

Αίτημα αποδοχής, παροχή lakehouse σε εξέλιξη.

Κεφαλίδες

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

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

InvalidItemType - Ο τύπος στοιχείου δεν είναι έγκυρος
ItemDisplayNameAlreadyInUse - Το εμφανιζόμενο όνομα στοιχείου χρησιμοποιείται ήδη.
CorruptedPayload - Το παρεχόμενο ωφέλιμο φορτίο είναι διεφθαρμένο.

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

Create a lakehouse example

Create a lakehouse with schema example

Create a lakehouse example

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

HTTP

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

{
  "displayName": "Lakehouse_1",
  "description": "A lakehouse description"
}

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

Κωδικός κατάστασης:: 201

{
  "displayName": "Lakehouse_1",
  "description": "A lakehouse description",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Κωδικός κατάστασης:: 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 lakehouse with schema example

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

HTTP

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

{
  "displayName": "Lakehouse_created_with_schema",
  "description": "A schema enabled lakehouse.",
  "creationPayload": {
    "enableSchemas": true
  }
}

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

Κωδικός κατάστασης:: 201

{
  "displayName": "Lakehouse_created_with_schema",
  "description": "A schema enabled lakehouse.",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Κωδικός κατάστασης:: 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

Ορισμοί

Όνομα	Περιγραφή
CreateLakehouseRequest	Δημιουργία ωφέλιμου φορτίου αίτησης σε λίμνη.
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
ItemType	Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου.
Lakehouse	Ένα στοιχείο lakehouse.
LakehouseCreationPayload	(Προεπισκόπηση) ωφέλιμο φορτίο στοιχείου Lakehouse. Αυτή η ιδιότητα είναι απαραίτητη αυτήν τη στιγμή, επειδή η λίμνη με δυνατότητα σχήματος βρίσκεται σε προεπισκόπηση. Μπορεί να καταστεί πλεονάζον με γενική διαθεσιμότητα (GA).
LakehouseProperties	Οι ιδιότητες του lakehouse.
SqlEndpointProperties	Ένα αντικείμενο που περιέχει τις ιδιότητες του τελικού σημείου SQL.
SqlEndpointProvisioningStatus	Ο τύπος κατάστασης παροχής τελικού σημείου SQL. Επιπλέον `SqlEndpointProvisioningStatus` τύποι μπορούν να προστεθούν με την πάροδο του χρόνου.

CreateLakehouseRequest

Object

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

Όνομα	Τύπος	Περιγραφή
creationPayload	LakehouseCreationPayload	Το ωφέλιμο φορτίο δημιουργίας του lakehouse.
description	string	Η περιγραφή του lakehouse. Το μέγιστο μήκος είναι 256 χαρακτήρες.
displayName	string	Το εμφανιζόμενο όνομα της λίμνης. Το εμφανιζόμενο όνομα πρέπει να ακολουθεί τους κανόνες ονομασίας σύμφωνα με τον τύπο στοιχείου.

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	Μια αποθήκη.

Lakehouse

Object

Ένα στοιχείο lakehouse.

Όνομα	Τύπος	Περιγραφή
description	string	Η περιγραφή του στοιχείου.
displayName	string	Το εμφανιζόμενο όνομα του στοιχείου.
id	string uuid	Το αναγνωριστικό στοιχείου.
properties	LakehouseProperties	Οι ιδιότητες του lakehouse.
type	ItemType	Ο τύπος στοιχείου.
workspaceId	string uuid	Το αναγνωριστικό χώρου εργασίας.

LakehouseCreationPayload

Object

(Προεπισκόπηση) ωφέλιμο φορτίο στοιχείου Lakehouse. Αυτή η ιδιότητα είναι απαραίτητη αυτήν τη στιγμή, επειδή η λίμνη με δυνατότητα σχήματος βρίσκεται σε προεπισκόπηση. Μπορεί να καταστεί πλεονάζον με γενική διαθεσιμότητα (GA).

Όνομα	Τύπος	Περιγραφή
enableSchemas	boolean	Δημιουργήστε μια λίμνη με δυνατότητα σχήματος όταν οριστεί σε true. Επιτρέπεται μόνο "true".

LakehouseProperties

Object

Οι ιδιότητες του lakehouse.

Όνομα	Τύπος	Περιγραφή
defaultSchema	string	Προεπιλεγμένο σχήμα της λίμνης. Αυτή η ιδιότητα επιστρέφεται μόνο για το lakehouse με δυνατότητα σχήματος.
oneLakeFilesPath	string	Διαδρομή OneLake στον κατάλογο αρχείων Lakehouse.
oneLakeTablesPath	string	Διαδρομή OneLake στον κατάλογο πινάκων Lakehouse.
sqlEndpointProperties	SqlEndpointProperties	Ένα αντικείμενο που περιέχει τις ιδιότητες του τελικού σημείου SQL.

SqlEndpointProperties

Object

Ένα αντικείμενο που περιέχει τις ιδιότητες του τελικού σημείου SQL.

Όνομα	Τύπος	Περιγραφή
connectionString	string	Συμβολοσειρά σύνδεσης τελικού σημείου SQL.
id	string	Αναγνωριστικό τελικού σημείου SQL.
provisioningStatus	SqlEndpointProvisioningStatus	Η κατάσταση παροχής τελικού σημείου SQL.

SqlEndpointProvisioningStatus

Απαρίθμηση

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

Τιμή	Περιγραφή
Failed	Η προμήθεια τελικού σημείου SQL απέτυχε.
InProgress	Η παροχή τελικού σημείου SQL βρίσκεται σε εξέλιξη.
Success	Η προμήθεια τελικού σημείου SQL ολοκληρώθηκε με επιτυχία.

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

Items - Create Lakehouse

Δικαιώματα

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

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

Διεπαφή

Παράμετροι URI

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

Αποκρίσεις

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

Create a lakehouse example

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

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

Create a lakehouse with schema example

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

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

Ορισμοί

CreateLakehouseRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemType

Lakehouse

LakehouseCreationPayload

LakehouseProperties

SqlEndpointProperties

SqlEndpointProvisioningStatus

Πρόσθετοι πόροι