Поделиться через

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
Other Status Codes

ErrorResponse

Распространенные коды ошибок:

  • InvalidItemType — недопустимый тип элемента.

  • ItemDisplayNameAlreadyInUse — отображаемое имя элемента уже используется.

  • Поврежденный Payload — предоставленные полезные данные повреждены.

  • WorkspaceItemsLimitExceed — превышено ограничение элемента рабочей области.

Примеры

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

Сведения об ответе на ошибку.
ItemTag

Представляет тег, примененный к элементу.
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

Отображаемое имя хранилища. Отображаемое имя должно соответствовать правилам именования в соответствии с типом элемента.
folderId

string (uuid)

Идентификатор папки. Если не указано или не задано значение NULL, хранилище создается с рабочей областью в качестве папки.

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

Сведения об ошибках, связанных с ресурсом.

ItemTag

Object

Представляет тег, примененный к элементу.

Имя Тип Описание
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

Определение задания Spark.
MLExperiment

Эксперимент машинного обучения.
MLModel

Модель машинного обучения.
Warehouse

Склад.
Eventstream

Поток событий.
SQLEndpoint

Конечная точка SQL.
MirroredWarehouse

Зеркальный склад.
MirroredDatabase

Зеркальная база данных.
Reflex

Рефлекс.
GraphQLApi

API для элемента GraphQL.
MountedDataFactory

ПодключеннаяdataFactory.
SQLDatabase

База данных SQLDatabase.
CopyJob

Задание копирования.
VariableLibrary

ПеременнаяLibrary.
Dataflow

Поток данных.
ApacheAirflowJob

An ApacheAirflowJob.
WarehouseSnapshot

Моментальный снимок хранилища.
DigitalTwinBuilder

A DigitalTwinBuilder.
DigitalTwinBuilderFlow

Поток Конструктора цифровых двойников.
MirroredAzureDatabricksCatalog

Зеркальный каталог azure databricks.

Warehouse

Object

Объект хранилища.

Имя Тип Описание
description

string

Описание элемента.
displayName

string

Отображаемое имя элемента.
folderId

string (uuid)

Идентификатор папки.
id

string (uuid)

Идентификатор элемента.
properties

WarehouseProperties

Свойства хранилища.
tags

ItemTag[]

Список примененных тегов.
type

ItemType

Тип элемента.
workspaceId

string (uuid)

Идентификатор рабочей области.

WarehouseCreationPayload

Object

Полезные данные для элементов хранилища

Имя Тип Описание
collationType

CollationType

Тип сортировки по умолчанию для хранилища.

WarehouseProperties

Object

Свойства элемента хранилища.

Имя Тип Описание
collationType

CollationType

Тип сортировки хранилища.
connectionString

string

Строка подключения SQL, подключенная к рабочей области, содержащей это хранилище.
createdDate

string (date-time)

Дата и время создания хранилища.
lastUpdatedTime

string (date-time)

Дата и время последнего обновления хранилища