Tables - Load Table

Servicio:: Lakehouse

Versión de la API:: v1

Inicia una operación de tabla de carga y devuelve la dirección URL de estado de la operación en el encabezado de ubicación de respuesta.

Note

Esta API forma parte de una versión preliminar y solo se proporciona con fines de evaluación y desarrollo. Puede cambiar en función de los comentarios y no se recomienda para su uso en producción.

Esta API admite operaciones de larga duración (LRO).

Permissions

Permiso de escritura en el elemento lakehouse.

Ámbitos delegados necesarios

Lakehouse.ReadWrite.All

Identidades admitidas de Microsoft Entra

Esta API admite las identidades de Microsoft enumeradas en esta sección.

Identity	Support
User	Yes
Entidad de servicio e Identidades administradas	Yes

Interface

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
lakehouseId	path	True	string (uuid)	Identificador del elemento lakehouse.
tableName	path	True	string pattern: ^(?=[0-9]*[a-zA-Z_])[a-zA-Z0-9_]{1,256}$	El nombre de la tabla.
workspaceId	path	True	string (uuid)	El identificador del área de trabajo.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
pathType	True	PathType	Tipo de `relativePath`, ya sea archivo o carpeta. Se pueden agregar tipos de `PathType` adicionales a lo largo del tiempo.
relativePath	True	string pattern: ^Files(\/[\p{L}\w]{1}([ \p{L}\w\.-][\p{L}\w\.-]{1}))*$	Ruta de acceso relativa del archivo de datos o carpeta.
fileExtension		string pattern: ^[a-zA-Z0-9_-]{1,16}$	Extensión de archivo del archivo de datos.
formatOptions		FileFormatOptions: Csv Parquet	Tipo abstracto de opciones de formato de archivo de datos.
mode		ModeType	Modo de operación de tabla de carga, sobrescribir o anexar. Se pueden agregar tipos de modo adicionales a lo largo del tiempo.
recursive		boolean	Indica si se van a buscar archivos de datos de forma recursiva o no, al cargar una tabla desde una carpeta.

Respuestas

Nombre	Tipo	Description
202 Accepted		Solicitud aceptada, la operación de la tabla de carga está en curso. Encabezados Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Códigos de error comunes: UnknownError: se produjo un error.

Nombre

Tipo

Description

202 Accepted

Solicitud aceptada, la operación de la tabla de carga está en curso.

Encabezados

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

Other Status Codes

ErrorResponse

Códigos de error comunes:

UnknownError: se produjo un error.

Ejemplos

Load table operation Example

Solicitud de ejemplo

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": ","
  }
}

Respuesta de muestra

status code:: 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

Definiciones

Nombre	Description
Csv	Opciones de formato CSV para archivos CSV.
ErrorRelatedResource	Objeto de detalles del recurso relacionado con el error.
ErrorResponse	Respuesta de error.
ErrorResponseDetails	Detalles de la respuesta de error.
LoadTableRequest	Representa una solicitud de operación de tabla de carga.
ModeType	Modo de operación de tabla de carga, sobrescribir o anexar. Se pueden agregar tipos de modo adicionales a lo largo del tiempo.
Parquet	Opciones de formato para archivos Parquet.
PathType	Tipo de `relativePath`, ya sea archivo o carpeta. Se pueden agregar tipos de `PathType` adicionales a lo largo del tiempo.

Csv

Object

Opciones de formato CSV para archivos CSV.

Nombre	Tipo	Description
delimiter	string pattern: ^[^\[\]\{\}'""]{0,8}$	Delimitador del archivo CSV.
format	string: Csv	Nombre del formato de archivo de datos. Se pueden agregar tipos de formato de archivo adicionales a lo largo del tiempo.
header	boolean	Esta propiedad indica si el archivo de datos CSV contiene una línea de encabezado o no.

ErrorRelatedResource

Object

Objeto de detalles del recurso relacionado con el error.

Nombre	Tipo	Description
resourceId	string	Identificador de recurso implicado en el error.
resourceType	string	Tipo del recurso implicado en el error.

ErrorResponse

Object

Respuesta de error.

Nombre	Tipo	Description
errorCode	string	Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message	string	Representación legible del error.
moreDetails	ErrorResponseDetails[]	Lista de detalles de error adicionales.
relatedResource	ErrorRelatedResource	Detalles del recurso relacionado con el error.
requestId	string	Identificador de la solicitud asociada al error.

ErrorResponseDetails

Object

Detalles de la respuesta de error.

Nombre	Tipo	Description
errorCode	string	Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message	string	Representación legible del error.
relatedResource	ErrorRelatedResource	Detalles del recurso relacionado con el error.

LoadTableRequest

Object

Representa una solicitud de operación de tabla de carga.

Nombre	Tipo	Description
fileExtension	string pattern: ^[a-zA-Z0-9_-]{1,16}$	Extensión de archivo del archivo de datos.
formatOptions	FileFormatOptions: Csv Parquet	Tipo abstracto de opciones de formato de archivo de datos.
mode	ModeType	Modo de operación de tabla de carga, sobrescribir o anexar. Se pueden agregar tipos de modo adicionales a lo largo del tiempo.
pathType	PathType	Tipo de `relativePath`, ya sea archivo o carpeta. Se pueden agregar tipos de `PathType` adicionales a lo largo del tiempo.
recursive	boolean	Indica si se van a buscar archivos de datos de forma recursiva o no, al cargar una tabla desde una carpeta.
relativePath	string pattern: ^Files(\/[\p{L}\w]{1}([ \p{L}\w\.-][\p{L}\w\.-]{1}))*$	Ruta de acceso relativa del archivo de datos o carpeta.

ModeType

Enumeración

Modo de operación de tabla de carga, sobrescribir o anexar. Se pueden agregar tipos de modo adicionales a lo largo del tiempo.

Valor	Description
Overwrite	cargar tabla en modo de sobrescritura.
Append	cargar tabla en modo de anexión.

Parquet

Object

Opciones de formato para archivos Parquet.

Nombre	Tipo	Description
format	string: Parquet	Nombre del formato de archivo de datos. Se pueden agregar tipos de formato de archivo adicionales a lo largo del tiempo.

PathType

Enumeración

Tipo de relativePath, ya sea archivo o carpeta. Se pueden agregar tipos de PathType adicionales a lo largo del tiempo.

Valor	Description
File	cargar tabla desde el archivo.
Folder	cargar la tabla desde la carpeta.

Nombre	Tipo	Description
delimiter	string pattern: ^[^\(\)\[\]\{\}'""]{0,8}$	Delimitador del archivo CSV.
format	string: Csv	Nombre del formato de archivo de datos. Se pueden agregar tipos de formato de archivo adicionales a lo largo del tiempo.
header	boolean	Esta propiedad indica si el archivo de datos CSV contiene una línea de encabezado o no.

Compartir a través de

Tables - Load Table

Permissions

Ámbitos delegados necesarios

Identidades admitidas de Microsoft Entra

Interface

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

Load table operation Example

Solicitud de ejemplo

Respuesta de muestra

Definiciones

Csv

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

LoadTableRequest

ModeType

Parquet

PathType