Freigeben über

Tables - Load Table

Dienst:
Lakehouse
API-Version:
v1

Startet einen Ladetabellenvorgang und gibt die Vorgangsstatus-URL im Antwortspeicherortheader zurück.

Note

Diese API ist Teil einer Preview-Version und wird nur für Evaluierungs- und Entwicklungszwecke bereitgestellt. Sie kann sich basierend auf Feedback ändern und wird nicht für den Produktionseinsatz empfohlen.

Diese API unterstützt LRO-.

Permissions

Schreibberechtigung für das Seehauselement.

Erforderliche delegierte Bereiche

Lakehouse.ReadWrite.All

Von Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.

Identity Support
User Yes
Service Principal und Verwaltete Identitäten Yes

Interface

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
lakehouseId
 path True

string (uuid)

Die Seehauselement-ID.
tableName
 path True

string

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

Der Tabellenname.
workspaceId
 path True

string (uuid)

Die Arbeitsbereichs-ID.

Anforderungstext

Name Erforderlich Typ Beschreibung
pathType True

PathType

Der Typ der Datei oder des Ordners relativePath. Zusätzliche PathType Typen können im Laufe der Zeit hinzugefügt werden.
relativePath True

string

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

Der relative Pfad der Datendatei oder des Ordners.
fileExtension

string

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

Die Dateierweiterung der Datendatei.
formatOptions FileFormatOptions:

Abstrakter Typ von Datendateiformatoptionen.
mode

ModeType

Der Vorgangsmodus "Tabelle laden", "Überschreiben" oder "Anfügen". Zusätzliche Modustypen können im Laufe der Zeit hinzugefügt werden.
recursive

boolean

Gibt an, ob Datendateien rekursiv oder nicht durchsucht werden sollen, wenn eine Tabelle aus einem Ordner geladen wird.

Antworten

Name Typ Beschreibung
202 Accepted

Der Vorgang "Akzeptierte Anforderung", "Tabelle laden" wird ausgeführt.

Header

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

ErrorResponse

Häufige Fehlercodes:

  • UnknownError – Ein Fehler ist aufgetreten.

Beispiele

Load table operation Example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
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

Definitionen

Name Beschreibung
Csv

CSV-Formatoptionen für CSV-Dateien.
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.
LoadTableRequest

Stellt eine Anforderung für den Ladetabellenvorgang dar.
ModeType

Der Vorgangsmodus "Tabelle laden", "Überschreiben" oder "Anfügen". Zusätzliche Modustypen können im Laufe der Zeit hinzugefügt werden.
Parquet

Formatoptionen für Parkettdateien.
PathType

Der Typ der Datei oder des Ordners relativePath. Zusätzliche PathType Typen können im Laufe der Zeit hinzugefügt werden.

Csv

Objekt

CSV-Formatoptionen für CSV-Dateien.

Name Typ Beschreibung
delimiter

string

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

Das Trennzeichen der CSV-Datei.
format string:

Csv

Name des Datendateiformats. Zusätzliche Dateiformattypen können im Laufe der Zeit hinzugefügt werden.
header

boolean

Diese Eigenschaft gibt an, ob die CSV-Datendatei eine Kopfzeile enthält oder nicht.

ErrorRelatedResource

Objekt

Das Fehlerbezogene Ressourcendetails-Objekt.

Name Typ Beschreibung
resourceId

string

Die Ressourcen-ID, die an dem Fehler beteiligt ist.
resourceType

string

Der Typ der Ressource, die an dem Fehler beteiligt ist.

ErrorResponse

Objekt

Die Fehlerantwort.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
moreDetails

ErrorResponseDetails[]

Liste der zusätzlichen Fehlerdetails.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.
requestId

string

ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Objekt

Die Fehlerantwortdetails.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.

LoadTableRequest

Objekt

Stellt eine Anforderung für den Ladetabellenvorgang dar.

Name Typ Beschreibung
fileExtension

string

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

Die Dateierweiterung der Datendatei.
formatOptions FileFormatOptions:

Abstrakter Typ von Datendateiformatoptionen.
mode

ModeType

Der Vorgangsmodus "Tabelle laden", "Überschreiben" oder "Anfügen". Zusätzliche Modustypen können im Laufe der Zeit hinzugefügt werden.
pathType

PathType

Der Typ der Datei oder des Ordners relativePath. Zusätzliche PathType Typen können im Laufe der Zeit hinzugefügt werden.
recursive

boolean

Gibt an, ob Datendateien rekursiv oder nicht durchsucht werden sollen, wenn eine Tabelle aus einem Ordner geladen wird.
relativePath

string

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

Der relative Pfad der Datendatei oder des Ordners.

ModeType

Enumeration

Der Vorgangsmodus "Tabelle laden", "Überschreiben" oder "Anfügen". Zusätzliche Modustypen können im Laufe der Zeit hinzugefügt werden.

Wert Beschreibung
Overwrite

Tabelle im Überschreibmodus laden.
Append

Tabelle im Anfügemodus laden.

Parquet

Objekt

Formatoptionen für Parkettdateien.

Name Typ Beschreibung
format string:

Parquet

Name des Datendateiformats. Zusätzliche Dateiformattypen können im Laufe der Zeit hinzugefügt werden.

PathType

Enumeration

Der Typ der Datei oder des Ordners relativePath. Zusätzliche PathType Typen können im Laufe der Zeit hinzugefügt werden.

Wert Beschreibung
File

Tabelle aus Datei laden.
Folder

Tabelle aus Ordner laden.