Udostępnij przez

Tables - Load Table

Usługa:
Lakehouse
Wersja interfejsu API:
v1

Uruchamia operację tabeli ładowania i zwraca adres URL stanu operacji w nagłówku lokalizacji odpowiedzi.

Note

Ten interfejs API jest częścią wersji zapoznawczej i jest dostarczany tylko do celów ewaluacyjnych i programistycznych. Może ona ulec zmianie na podstawie opinii i nie jest zalecana do użytku produkcyjnego.

Ten interfejs API obsługuje długotrwałych operacji (LRO).

Permissions

Uprawnienie do zapisu do elementu lakehouse.

Wymagane zakresy delegowane

Lakehouse.ReadWrite.All

Tożsamości obsługiwane przez Microsoft Entra

To API obsługuje tożsamości Microsoft wymienione w tej sekcji.

Identity Support
User Yes
Główne usługi i Tożsamości zarządzane Yes

Interface

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
lakehouseId
 path True

string (uuid)

Identyfikator elementu lakehouse.
tableName
 path True

string

pattern: ^(?=[0-9]*[a-zA-Z_])[a-zA-Z0-9_]{1,256}$

Nazwa tabeli
workspaceId
 path True

string (uuid)

Identyfikator przestrzeni roboczej.

Treść żądania

Nazwa Wymagane Typ Opis
pathType True

PathType

Typ relativePathpliku lub folderu . Dodatkowe typy PathType można dodawać w czasie.
relativePath True

string

pattern: ^Files(\/[\p{L}\w]{1}([ \p{L}\w\.-]*[\p{L}\w\.-]{1})*)*$

Ścieżka względna pliku lub folderu danych.
fileExtension

string

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

Rozszerzenie pliku danych.
formatOptions FileFormatOptions:

Abstrakcyjny typ opcji formatu pliku danych.
mode

ModeType

Tryb operacji tabeli ładowania, zastępowanie lub dołączanie. Dodatkowe typy trybów można dodawać w czasie.
recursive

boolean

Wskazuje, czy pliki danych mają być przeszukiwane rekursywnie, czy nie, podczas ładowania tabeli z folderu.

Odpowiedzi

Nazwa Typ Opis
202 Accepted

Żądanie zaakceptowane, trwa operacja ładowania tabeli.

Nagłówki

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

ErrorResponse

Typowe kody błędów:

  • UnknownError — wystąpił błąd.

Przykłady

Load table operation Example

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
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

Definicje

Nazwa Opis
Csv

Opcje formatu CSV dla plików CSV.
ErrorRelatedResource

Obiekt szczegółów zasobu powiązanego z błędem.
ErrorResponse

Odpowiedź na błąd.
ErrorResponseDetails

Szczegóły odpowiedzi na błąd.
LoadTableRequest

Reprezentuje żądanie operacji tabeli ładowania.
ModeType

Tryb operacji tabeli ładowania, zastępowanie lub dołączanie. Dodatkowe typy trybów można dodawać w czasie.
Parquet

Opcje formatowania plików Parquet.
PathType

Typ relativePathpliku lub folderu . Dodatkowe typy PathType można dodawać w czasie.

Csv

Objekt

Opcje formatu CSV dla plików CSV.

Nazwa Typ Opis
delimiter

string

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

Ogranicznik pliku CSV.
format string:

Csv

Nazwa formatu pliku danych. Dodatkowe typy formatów plików można dodawać w czasie.
header

boolean

Ta właściwość wskazuje, czy plik danych CSV zawiera wiersz nagłówka, czy nie.

ErrorRelatedResource

Objekt

Obiekt szczegółów zasobu powiązanego z błędem.

Nazwa Typ Opis
resourceId

string

Identyfikator zasobu, który jest zaangażowany w błąd.
resourceType

string

Typ zasobu, który jest zaangażowany w błąd.

ErrorResponse

Objekt

Odpowiedź na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
moreDetails

ErrorResponseDetails[]

Lista dodatkowych szczegółów błędu.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.
requestId

string

Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Objekt

Szczegóły odpowiedzi na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.

LoadTableRequest

Objekt

Reprezentuje żądanie operacji tabeli ładowania.

Nazwa Typ Opis
fileExtension

string

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

Rozszerzenie pliku danych.
formatOptions FileFormatOptions:

Abstrakcyjny typ opcji formatu pliku danych.
mode

ModeType

Tryb operacji tabeli ładowania, zastępowanie lub dołączanie. Dodatkowe typy trybów można dodawać w czasie.
pathType

PathType

Typ relativePathpliku lub folderu . Dodatkowe typy PathType można dodawać w czasie.
recursive

boolean

Wskazuje, czy pliki danych mają być przeszukiwane rekursywnie, czy nie, podczas ładowania tabeli z folderu.
relativePath

string

pattern: ^Files(\/[\p{L}\w]{1}([ \p{L}\w\.-]*[\p{L}\w\.-]{1})*)*$

Ścieżka względna pliku lub folderu danych.

ModeType

Wyliczanie

Tryb operacji tabeli ładowania, zastępowanie lub dołączanie. Dodatkowe typy trybów można dodawać w czasie.

Wartość Opis
Overwrite

ładowanie tabeli w trybie zastępowania.
Append

ładowanie tabeli w trybie dołączania.

Parquet

Objekt

Opcje formatowania plików Parquet.

Nazwa Typ Opis
format string:

Parquet

Nazwa formatu pliku danych. Dodatkowe typy formatów plików można dodawać w czasie.

PathType

Wyliczanie

Typ relativePathpliku lub folderu . Dodatkowe typy PathType można dodawać w czasie.

Wartość Opis
File

załaduj tabelę z pliku.
Folder

załaduj tabelę z folderu.