Tables - Load Table

Служба:: Lakehouse

Версия API:: v1

Запускает операцию загрузки таблицы и возвращает URL-адрес состояния операции в заголовке расположения ответа.

Note

Этот API является частью предварительного выпуска и предоставляется только для оценки и разработки. Он может измениться на основе отзывов и не рекомендуется для использования в рабочей среде.

Этот API поддерживает длительные операции (LRO).

Permissions

Разрешение на запись в элемент Lakehouse.

Обязательные делегированные области

Lakehouse.ReadWrite.All

Идентификаторы, поддерживаемые Microsoft Entra

Этот API поддерживает идентичности Microsoft, перечисленные в этом разделе.

Identity	Support
User	Yes
Представитель службы и управляемые удостоверения	Yes

Interface

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/lakehouses/{lakehouseId}/tables/{tableName}/load

Параметры URI

Имя	В	Обязательно	Тип	Описание
lakehouseId	path	True	string (uuid)	Идентификатор элемента Lakehouse.
tableName	path	True	string pattern: ^(?=[0-9]*[a-zA-Z_])[a-zA-Z0-9_]{1,256}$	Имя таблицы.
workspaceId	path	True	string (uuid)	Идентификатор рабочей области.

Текст запроса

Имя	Обязательно	Тип	Описание
pathType	True	PathType	Тип `relativePath`файла или папки. С течением времени могут добавляться дополнительные `PathType` типы.
relativePath	True	string pattern: ^Files(\/[\p{L}\w]{1}([ \p{L}\w\.-][\p{L}\w\.-]{1}))*$	Относительный путь к файлу данных или папке.
fileExtension		string pattern: ^[a-zA-Z0-9_-]{1,16}$	Расширение файла данных.
formatOptions		FileFormatOptions: Csv Parquet	Абстрактный тип параметров формата файла данных.
mode		ModeType	Режим работы таблицы загрузки, перезапись или добавление. С течением времени могут добавляться дополнительные типы режимов.
recursive		boolean	Указывает, следует ли выполнять рекурсивный поиск файлов данных при загрузке таблицы из папки.

Ответы

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

202 Accepted

Имя	Тип	Описание
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	Распространенные коды ошибок: UnknownError — произошла ошибка.

Запрос принят, выполняется операция загрузки таблицы.

Заголовки

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

429 Too Many Requests

ErrorResponse

Превышено ограничение скорости обслуживания. Сервер возвращает заголовок, указывающий Retry-After в секундах, сколько времени клиент должен ждать перед отправкой дополнительных запросов.

Заголовки

Retry-After: integer

Other Status Codes

ErrorResponse

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

UnknownError — произошла ошибка.

Примеры

Load table operation Example

Образец запроса

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/lakehouses/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/tables/abc123/load

{
  "relativePath": "Files/abc/abc123.csv",
  "pathType": "File",
  "mode": "Overwrite",
  "recursive": false,
  "formatOptions": {
    "format": "Csv",
    "header": true,
    "delimiter": ","
  }
}

Пример ответа

Код состояния:: 202

Location: https://api.fabric.microsoft.com/v1/operations/abcdef00-9d7e-469a-abf1-fca847a0ea69
x-ms-operation-id: abcdef00-9d7e-469a-abf1-fca847a0ea69
Retry-After: 30

Определения

Имя	Описание
Csv	Параметры формата CSV для CSV-файлов.
ErrorRelatedResource	Объект сведений об ошибках, связанных с ресурсом.
ErrorResponse	Ответ на ошибку.
ErrorResponseDetails	Сведения об ответе на ошибку.
LoadTableRequest	Представляет запрос операции загрузки таблицы.
ModeType	Режим работы таблицы загрузки, перезапись или добавление. С течением времени могут добавляться дополнительные типы режимов.
Parquet	Параметры форматирования файлов Parquet.
PathType	Тип `relativePath`файла или папки. С течением времени могут добавляться дополнительные `PathType` типы.

Csv

Объект

Параметры формата CSV для CSV-файлов.

Имя	Тип	Описание
delimiter	string pattern: ^[^\[\]\{\}'""]{0,8}$	Разделитель CSV-файла.
format	string: Csv	Имя формата файла данных. С течением времени могут добавляться дополнительные типы форматов файлов.
header	boolean	Это свойство указывает, содержит ли CSV-файл данных строку заголовка или нет.

ErrorRelatedResource

Объект

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

Имя	Тип	Описание
resourceId	string	Идентификатор ресурса, участвующий в ошибке.
resourceType	string	Тип ресурса, который участвует в ошибке.

ErrorResponse

Объект

Ответ на ошибку.

Имя	Тип	Описание
errorCode	string	Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message	string	Удобочитаемое представление ошибки.
moreDetails	ErrorResponseDetails[]	Список дополнительных сведений об ошибке.
relatedResource	ErrorRelatedResource	Сведения об ошибках, связанных с ресурсом.
requestId	string (uuid)	Идентификатор запроса, связанного с ошибкой.

ErrorResponseDetails

Объект

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

Имя	Тип	Описание
errorCode	string	Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message	string	Удобочитаемое представление ошибки.
relatedResource	ErrorRelatedResource	Сведения об ошибках, связанных с ресурсом.

LoadTableRequest

Объект

Представляет запрос операции загрузки таблицы.

Имя	Тип	Описание
fileExtension	string pattern: ^[a-zA-Z0-9_-]{1,16}$	Расширение файла данных.
formatOptions	FileFormatOptions: Csv Parquet	Абстрактный тип параметров формата файла данных.
mode	ModeType	Режим работы таблицы загрузки, перезапись или добавление. С течением времени могут добавляться дополнительные типы режимов.
pathType	PathType	Тип `relativePath`файла или папки. С течением времени могут добавляться дополнительные `PathType` типы.
recursive	boolean	Указывает, следует ли выполнять рекурсивный поиск файлов данных при загрузке таблицы из папки.
relativePath	string pattern: ^Files(\/[\p{L}\w]{1}([ \p{L}\w\.-][\p{L}\w\.-]{1}))*$	Относительный путь к файлу данных или папке.

ModeType

Перечисление

Режим работы таблицы загрузки, перезапись или добавление. С течением времени могут добавляться дополнительные типы режимов.

Значение	Описание
Overwrite	загрузите таблицу в режиме перезаписи.
Append	загрузка таблицы в режиме добавления.

Parquet

Объект

Параметры форматирования файлов Parquet.

Имя	Тип	Описание
format	string: Parquet	Имя формата файла данных. С течением времени могут добавляться дополнительные типы форматов файлов.

PathType

Перечисление

Тип relativePathфайла или папки. С течением времени могут добавляться дополнительные PathType типы.

Значение	Описание
File	загрузите таблицу из файла.
Folder	загрузите таблицу из папки.

Имя	Тип	Описание
delimiter	string pattern: ^[^\(\)\[\]\{\}'""]{0,8}$	Разделитель CSV-файла.
format	string: Csv	Имя формата файла данных. С течением времени могут добавляться дополнительные типы форматов файлов.
header	boolean	Это свойство указывает, содержит ли CSV-файл данных строку заголовка или нет.