Items - Create Warehouse

Υπηρεσία:: Warehouse

Έκδοση API:: v1

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

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

Δικαιώματα

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

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

Warehouse.ReadWrite.All ή Item.ReadWrite.All

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

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

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

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

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

Διεπαφή

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

Παράμετροι URI

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

Σώμα αιτήματος

Όνομα	Απαιτούμενο	Δακτυλογραφώ	Περιγραφή
displayName	True	string	Το εμφανιζόμενο όνομα της αποθήκης. Το εμφανιζόμενο όνομα πρέπει να ακολουθεί τους κανόνες ονομασίας σύμφωνα με τον τύπο στοιχείου.
creationPayload		WarehouseCreationPayload	Το ωφέλιμο φορτίο δημιουργίας αποθήκης. Χρησιμοποιήστε `creationPayload`. Δεν μπορείτε να χρησιμοποιήσετε `definition` ή `creationPayload` ταυτόχρονα.
description		string	Η περιγραφή της αποθήκης. Το μέγιστο μήκος είναι 256 χαρακτήρες.
folderId		string (uuid)	Το αναγνωριστικό φακέλου. Εάν δεν καθορίζεται ή null, η αποθήκη δημιουργείται με τον χώρο εργασίας ως φάκελο.

Απαντήσεις

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

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

Create a warehouse example

Create a warehouse example with payload

Create a warehouse example

Αίτημα δείγματος

HTTP

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

{
  "displayName": "Warehouse 1",
  "description": "A warehouse description."
}

Δείγμα απάντησης

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

{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "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 warehouse example with payload

Αίτημα δείγματος

HTTP

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

{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "creationPayload": {
    "collationType": "Latin1_General_100_CI_AS_KS_WS_SC_UTF8"
  }
}

Δείγμα απάντησης

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

{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "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

Ορισμοί

Όνομα	Περιγραφή
CollationType	Σειρά ταξινόμησης αποθήκης. Επιπλέον `collations` μπορούν να προστεθούν με την πάροδο του χρόνου.
CreateWarehouseRequest	Δημιουργήστε ωφέλιμο φορτίο αίτησης αποθήκης.
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
ItemTag	Αντιπροσωπεύει μια ετικέτα που έχει εφαρμοστεί σε ένα στοιχείο.
ItemType	Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου.
Warehouse	Ένα αντικείμενο αποθήκης.
WarehouseCreationPayload	Ωφέλιμο φορτίο στοιχείου αποθήκης
WarehouseProperties	Οι ιδιότητες στοιχείου αποθήκης.

CollationType

Απαρίθμηση

Σειρά ταξινόμησης αποθήκης. Επιπλέον collations μπορούν να προστεθούν με την πάροδο του χρόνου.

Τιμή	Περιγραφή
Latin1_General_100_BIN2_UTF8	Η προεπιλογή - σειρά διάκρισης πεζών-κεφαλαίων (CS)
Latin1_General_100_CI_AS_KS_WS_SC_UTF8	Σειρά ταξινόμησης χωρίς διάκριση πεζών-κεφαλαίων (CI)

CreateWarehouseRequest

Αντικείμενο

Δημιουργήστε ωφέλιμο φορτίο αίτησης αποθήκης.

Όνομα	Δακτυλογραφώ	Περιγραφή
creationPayload	WarehouseCreationPayload	Το ωφέλιμο φορτίο δημιουργίας αποθήκης. Χρησιμοποιήστε `creationPayload`. Δεν μπορείτε να χρησιμοποιήσετε `definition` ή `creationPayload` ταυτόχρονα.
description	string	Η περιγραφή της αποθήκης. Το μέγιστο μήκος είναι 256 χαρακτήρες.
displayName	string	Το εμφανιζόμενο όνομα της αποθήκης. Το εμφανιζόμενο όνομα πρέπει να ακολουθεί τους κανόνες ονομασίας σύμφωνα με τον τύπο στοιχείου.
folderId	string (uuid)	Το αναγνωριστικό φακέλου. Εάν δεν καθορίζεται ή null, η αποθήκη δημιουργείται με τον χώρο εργασίας ως φάκελο.

ErrorRelatedResource

Αντικείμενο

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

Όνομα	Δακτυλογραφώ	Περιγραφή
resourceId	string	Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.
resourceType	string	Ο τύπος του πόρου που εμπλέκεται στο σφάλμα.

ErrorResponse

Αντικείμενο

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

Όνομα	Δακτυλογραφώ	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
moreDetails	ErrorResponseDetails[]	Λίστα πρόσθετων λεπτομερειών σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.
requestId	string (uuid)	Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα.

ErrorResponseDetails

Αντικείμενο

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

Όνομα	Δακτυλογραφώ	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

ItemTag

Αντικείμενο

Αντιπροσωπεύει μια ετικέτα που έχει εφαρμοστεί σε ένα στοιχείο.

Όνομα	Δακτυλογραφώ	Περιγραφή
displayName	string	Το όνομα της ετικέτας.
id	string (uuid)	Το αναγνωριστικό ετικέτας.

ItemType

Απαρίθμηση

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

Τιμή	Περιγραφή
Dashboard	Πίνακας εργαλείων του PowerBI.
Report	Αναφορά PowerBI.
SemanticModel	Σημασιολογικό μοντέλο PowerBI.
PaginatedReport	Σελιδοποιημένη αναφορά PowerBI.
Datamart	Datamart του PowerBI.
Lakehouse	Ένα λιμνοθάσπιτο.
Eventhouse	Μια εκδήλωση.
Environment	Ένα περιβάλλον.
KQLDatabase	Μια βάση δεδομένων KQL.
KQLQueryset	Ένα σύνολο ερωτημάτων KQL.
KQLDashboard	Ένας πίνακας εργαλείων KQL.
DataPipeline	Μια διοχέτευση δεδομένων.
Notebook	Ένα σημειωματάριο.
SparkJobDefinition	Ένας ορισμός εργασίας σπινθήρα.
MLExperiment	Ένα πείραμα εκμάθησης μηχανής.
MLModel	Ένα μοντέλο εκμάθησης μηχανής.
Warehouse	Μια αποθήκη.
Eventstream	Μια ροή συμβάντος.
SQLEndpoint	Ένα τελικό σημείο SQL.
MirroredWarehouse	Μια αποθήκη με κατοπτρικό καθρέφτη.
MirroredDatabase	Μια βάση δεδομένων κατοπτρισμού.
Reflex	Αντανακλαστικά.
GraphQLApi	Ένα API για το στοιχείο GraphQL.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	Μια βάση δεδομένων SQL.
CopyJob	Μια εργασία αντιγραφής.
VariableLibrary	Μια μεταβλητήLibrary.
Dataflow	Μια ροή δεδομένων.
ApacheAirflowJob	Ένα ApacheAirflowJob.
WarehouseSnapshot	Ένα στιγμιότυπο αποθήκης.
DigitalTwinBuilder	Μια DigitalTwinBuilder.
DigitalTwinBuilderFlow	Μια ψηφιακή ροή Twin Builder.
MirroredAzureDatabricksCatalog	Ένας κατοπτρικός κατάλογος azure databricks.
Map	Ένας χάρτης.
AnomalyDetector	Ένας εντοπισμός ανωμαλιών.
UserDataFunction	Μια συνάρτηση δεδομένων χρήστη.
GraphModel	Ένα GraphModel.
GraphQuerySet	Ένα σύνολο ερωτημάτων Graph.
SnowflakeDatabase	Μια βάση δεδομένων Snowflake για την αποθήκευση πινάκων Iceberg που δημιουργήθηκαν από τον λογαριασμό Snowflake.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Μια βάση δεδομένων Cosmos DB.
Ontology	Μια ογκολογία.
EventSchemaSet	Ένα EventSchemaSet.
DataAgent	Ένας DataAgent.

Warehouse

Αντικείμενο

Ένα αντικείμενο αποθήκης.

Όνομα	Δακτυλογραφώ	Περιγραφή
description	string	Η περιγραφή του στοιχείου.
displayName	string	Το εμφανιζόμενο όνομα του στοιχείου.
folderId	string (uuid)	Το αναγνωριστικό φακέλου.
id	string (uuid)	Το αναγνωριστικό στοιχείου.
properties	WarehouseProperties	Οι ιδιότητες αποθήκης.
tags	ItemTag[]	Λίστα εφαρμοσμένων ετικετών.
type	ItemType	Ο τύπος στοιχείου.
workspaceId	string (uuid)	Το αναγνωριστικό χώρου εργασίας.

WarehouseCreationPayload

Αντικείμενο

Ωφέλιμο φορτίο στοιχείου αποθήκης

Όνομα	Δακτυλογραφώ	Περιγραφή
collationType	CollationType	Ο προεπιλεγμένος τύπος σειράς ταξινόμησης της αποθήκης.

WarehouseProperties

Αντικείμενο

Οι ιδιότητες στοιχείου αποθήκης.

Όνομα	Δακτυλογραφώ	Περιγραφή
collationType	CollationType	Ο τύπος σειράς ταξινόμησης της αποθήκης.
connectionString	string	Η συμβολοσειρά σύνδεσης SQL που είναι συνδεδεμένη στον χώρο εργασίας που περιέχει αυτή την αποθήκη.
createdDate	string (date-time)	Η ημερομηνία και ώρα δημιουργίας της αποθήκης.
lastUpdatedTime	string (date-time)	Η ημερομηνία και ώρα τελευταίας ενημέρωσης της αποθήκης

Κοινοποίηση μέσω

Items - Create Warehouse

Δικαιώματα

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

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

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

Διεπαφή

Παράμετροι URI

Σώμα αιτήματος

Απαντήσεις

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

Create a warehouse example

Αίτημα δείγματος

Δείγμα απάντησης

Create a warehouse example with payload

Αίτημα δείγματος

Δείγμα απάντησης

Ορισμοί

CollationType

CreateWarehouseRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

Warehouse

WarehouseCreationPayload

WarehouseProperties