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

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 χαρακτήρες.

Αποκρίσεις

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

Warehouse

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

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

Κεφαλίδες

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

ErrorResponse

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

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

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

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

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

Create a warehouse example
Create a warehouse example with payload

Create a warehouse example

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

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

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

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

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

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

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

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

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

CollationType

Απαρίθμηση

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

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

Η προεπιλογή - σειρά διάκρισης πεζών-κεφαλαίων (CS)
Latin1_General_100_CI_AS_KS_WS_SC_UTF8

Σειρά ταξινόμησης χωρίς διάκριση πεζών-κεφαλαίων (CI)

CreateWarehouseRequest

Object

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

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

WarehouseCreationPayload

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

string

Η περιγραφή της αποθήκης. Το μέγιστο μήκος είναι 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

Μια αποθήκη.

Warehouse

Object

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

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

string

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

string

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

string

uuid

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

WarehouseProperties

Οι ιδιότητες αποθήκης.
type

ItemType

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

string

uuid

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

WarehouseCreationPayload

Object

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

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

CollationType

Ο προεπιλεγμένος τύπος σειράς ταξινόμησης της αποθήκης.

WarehouseProperties

Object

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

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

CollationType

Ο τύπος σειράς ταξινόμησης της αποθήκης.
connectionString

string

Η συμβολοσειρά σύνδεσης SQL που είναι συνδεδεμένη στον χώρο εργασίας που περιέχει αυτή την αποθήκη.
createdDate

string

date-time

Η ημερομηνία και ώρα δημιουργίας της αποθήκης.
lastUpdatedTime

string

date-time

Η ημερομηνία και ώρα τελευταίας ενημέρωσης της αποθήκης