Udostępnij za pośrednictwem

Library - Append

  • Odwołanie
Usługa:
Synapse
Wersja interfejsu API:
2020-12-01

Dołącz zawartość do zasobu biblioteki utworzonego przy użyciu operacji tworzenia. Maksymalny rozmiar zawartości to 4MiB. Zawartość większa niż 4MiB musi być dołączona w fragmentach 4MiB

PUT {endpoint}/libraries/{libraryName}?api-version=2020-12-01&comp=appendblock

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
endpoint
 path True

string

uri

Punkt końcowy programowania obszaru roboczego, na przykład https://myworkspace.dev.azuresynapse.net.
libraryName
 path True

string

nazwa pliku do przekazania. Minimalna długość nazwy pliku powinna wynosić 1 z wyłączeniem długości rozszerzenia.
api-version
 query True

string

Wersja interfejsu API klienta usługi Synapse.
comp
 query True

string

Nagłówek żądania

Media Types: "application/octet-stream"

Nazwa Wymagane Typ Opis
x-ms-blob-condition-appendpos

integer

int64

Ustaw ten nagłówek na przesunięcie bajtów, przy którym blok ma zostać dołączony. Żądanie powiedzie się tylko wtedy, gdy bieżące przesunięcie pasuje do tej wartości. W przeciwnym razie żądanie kończy się niepowodzeniem z powodu błędu AppendPositionConditionNotMet (kod stanu HTTP 412 — Niepowodzenie warunku wstępnego)

Treść żądania

Media Types: "application/octet-stream"

Nazwa Typ Opis
content

string

Fragment pliku biblioteki.

Odpowiedzi

Nazwa Typ Opis
201 Created

Utworzone.
Other Status Codes

CloudError

Odpowiedź o błędzie odebrana z usługi Azure Synapse.

Przykłady

Append Library

Przykładowe żądanie

PUT exampleWorkspace.dev.azuresynapse.net/libraries/exampleLibraryName.jar?api-version=2020-12-01&comp=appendblock


"file binary chunk"

Przykładowa odpowiedź

Kod stanu:
201 
Date: Fri, 23 Oct 2020 08:28:16 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-writes: 1192
x-ms-request-id: e4c589b7-a9fe-4c28-981c-3855ec27d264
x-ms-correlation-request-id: e4c589b7-a9fe-4c28-981c-3855ec27d264

Definicje

CloudError

Obiekt, który definiuje strukturę odpowiedzi Azure Synapse błędu.

Nazwa Typ Opis
error.code

string

Kod błędu.
error.details

CloudError[]

Tablica z dodatkowymi szczegółami błędu.
error.message

string

Komunikat o błędzie.
error.target

string

Nazwa/ścieżka właściwości w żądaniu skojarzonym z błędem.