Tables - Load Table

Serviço:: Lakehouse

Versão da API:: v1

Inicia uma operação de tabela de carregamento e retorna a URL de status da operação no cabeçalho do local de resposta.

Note

Esta API faz parte de uma versão de pré-visualização e é fornecida apenas para fins de avaliação e desenvolvimento. Ele pode mudar com base no feedback e não é recomendado para uso em produção.

Esta API suporta operações de longa duração (LRO).

Permissions

Escreva permissão para o item lakehouse.

Escopos delegados necessários

Lakehouse.ReadWrite.All

Identidades suportadas pelo Entra da Microsoft

Esta API suporta as identidades do Microsoft listadas nesta secção.

Identity	Support
User	Yes
Entidade de serviço e identidades geridas	Yes

Interface

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
lakehouseId	path	True	string (uuid)	O ID do item lakehouse.
tableName	path	True	string pattern: ^(?=[0-9]*[a-zA-Z_])[a-zA-Z0-9_]{1,256}$	O nome da tabela.
workspaceId	path	True	string (uuid)	O ID do espaço de trabalho.

Corpo do Pedido

Name	Necessário	Tipo	Description
pathType	True	PathType	O tipo de `relativePath`arquivo ou pasta. Tipos de `PathType` adicionais podem ser adicionados ao longo do tempo.
relativePath	True	string pattern: ^Files(\/[\p{L}\w]{1}([ \p{L}\w\.-][\p{L}\w\.-]{1}))*$	O caminho relativo do arquivo ou pasta de dados.
fileExtension		string pattern: ^[a-zA-Z0-9_-]{1,16}$	A extensão do arquivo de dados.
formatOptions		FileFormatOptions: Csv Parquet	Tipo abstrato de opções de formato de arquivo de dados.
mode		ModeType	O modo de operação da tabela de carga, substituir ou acrescentar. Tipos de modo adicionais podem ser adicionados ao longo do tempo.
recursive		boolean	Indica se os arquivos de dados devem ser pesquisados recursivamente ou não, ao carregar uma tabela de uma pasta.

Respostas

Name	Tipo	Description
202 Accepted		Pedido aceite, a operação da tabela de carga está em curso. Cabeçalhos Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Códigos de erro comuns: UnknownError - Ocorreu um erro.

Name

Tipo

Description

202 Accepted

Pedido aceite, a operação da tabela de carga está em curso.

Cabeçalhos

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

Other Status Codes

ErrorResponse

Códigos de erro comuns:

UnknownError - Ocorreu um erro.

Exemplos

Load table operation Example

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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

Definições

Name	Description
Csv	Opções de formato CSV para ficheiros CSV.
ErrorRelatedResource	O objeto de detalhes do recurso relacionado ao erro.
ErrorResponse	A resposta de erro.
ErrorResponseDetails	Os detalhes da resposta de erro.
LoadTableRequest	Representa uma solicitação de operação de tabela de carga.
ModeType	O modo de operação da tabela de carga, substituir ou acrescentar. Tipos de modo adicionais podem ser adicionados ao longo do tempo.
Parquet	Opções de formato para arquivos Parquet.
PathType	O tipo de `relativePath`arquivo ou pasta. Tipos de `PathType` adicionais podem ser adicionados ao longo do tempo.

Csv

Object

Opções de formato CSV para ficheiros CSV.

Name	Tipo	Description
delimiter	string pattern: ^[^\[\]\{\}'""]{0,8}$	O delimitador do arquivo CSV.
format	string: Csv	Nome do formato do arquivo de dados. Tipos de formato de arquivo adicionais podem ser adicionados ao longo do tempo.
header	boolean	Essa propriedade indica se o arquivo de dados CSV contém uma linha de cabeçalho ou não.

ErrorRelatedResource

Object

O objeto de detalhes do recurso relacionado ao erro.

Name	Tipo	Description
resourceId	string	A ID do recurso envolvida no erro.
resourceType	string	O tipo de recurso envolvido no erro.

ErrorResponse

Object

A resposta de erro.

Name	Tipo	Description
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message	string	Uma representação legível por humanos do erro.
moreDetails	ErrorResponseDetails[]	Lista de detalhes de erro adicionais.
relatedResource	ErrorRelatedResource	Os detalhes do recurso relacionados ao erro.
requestId	string	ID da solicitação associada ao erro.

ErrorResponseDetails

Object

Os detalhes da resposta de erro.

Name	Tipo	Description
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message	string	Uma representação legível por humanos do erro.
relatedResource	ErrorRelatedResource	Os detalhes do recurso relacionados ao erro.

LoadTableRequest

Object

Representa uma solicitação de operação de tabela de carga.

Name	Tipo	Description
fileExtension	string pattern: ^[a-zA-Z0-9_-]{1,16}$	A extensão do arquivo de dados.
formatOptions	FileFormatOptions: Csv Parquet	Tipo abstrato de opções de formato de arquivo de dados.
mode	ModeType	O modo de operação da tabela de carga, substituir ou acrescentar. Tipos de modo adicionais podem ser adicionados ao longo do tempo.
pathType	PathType	O tipo de `relativePath`arquivo ou pasta. Tipos de `PathType` adicionais podem ser adicionados ao longo do tempo.
recursive	boolean	Indica se os arquivos de dados devem ser pesquisados recursivamente ou não, ao carregar uma tabela de uma pasta.
relativePath	string pattern: ^Files(\/[\p{L}\w]{1}([ \p{L}\w\.-][\p{L}\w\.-]{1}))*$	O caminho relativo do arquivo ou pasta de dados.

ModeType

Enumeração

O modo de operação da tabela de carga, substituir ou acrescentar. Tipos de modo adicionais podem ser adicionados ao longo do tempo.

Valor	Description
Overwrite	carregar tabela no modo de substituição.
Append	Carregar tabela no modo de acréscimo.

Parquet

Object

Opções de formato para arquivos Parquet.

Name	Tipo	Description
format	string: Parquet	Nome do formato do arquivo de dados. Tipos de formato de arquivo adicionais podem ser adicionados ao longo do tempo.

PathType

Enumeração

O tipo de relativePatharquivo ou pasta. Tipos de PathType adicionais podem ser adicionados ao longo do tempo.

Valor	Description
File	carregar tabela do arquivo.
Folder	carregar tabela da pasta.

Name	Tipo	Description
delimiter	string pattern: ^[^\(\)\[\]\{\}'""]{0,8}$	O delimitador do arquivo CSV.
format	string: Csv	Nome do formato do arquivo de dados. Tipos de formato de arquivo adicionais podem ser adicionados ao longo do tempo.
header	boolean	Essa propriedade indica se o arquivo de dados CSV contém uma linha de cabeçalho ou não.

Partilhar via

Tables - Load Table

Permissions

Escopos delegados necessários

Identidades suportadas pelo Entra da Microsoft

Interface

Parâmetros do URI

Corpo do Pedido

Respostas

Exemplos

Load table operation Example

Pedido de amostra

Resposta da amostra

Definições

Csv

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

LoadTableRequest

ModeType

Parquet

PathType