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

Tables - Load Table

Служба:
Lakehouse
Версия API:
v1

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

Note

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

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

Permissions

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

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

Lakehouse.ReadWrite.All

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

This API supports the Microsoft identities listed in this section.

Identity Support
User Yes
Service principal and Managed identities 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:

Абстрактный тип параметров формата файла данных.
mode

ModeType

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

boolean

Указывает, следует ли выполнять рекурсивный поиск файлов данных при загрузке таблицы из папки.

Ответы

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

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

Заголовки

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

ErrorResponse

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

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

Примеры

Load table operation Example

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

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

Object

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

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

string

pattern: ^[^\(\)\[\]\{\}'""]{0,8}$

Разделитель CSV-файла.
format string:

Csv

Имя формата файла данных. С течением времени могут добавляться дополнительные типы форматов файлов.
header

boolean

Это свойство указывает, содержит ли CSV-файл данных строку заголовка или нет.

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

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

LoadTableRequest

Object

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

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

string

pattern: ^[a-zA-Z0-9_-]{1,16}$

Расширение файла данных.
formatOptions FileFormatOptions:

Абстрактный тип параметров формата файла данных.
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

Object

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

Имя Тип Описание
format string:

Parquet

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

PathType

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

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

Значение Описание
File

загрузите таблицу из файла.
Folder

загрузите таблицу из папки.