Library - Append

Referenz

Service:: Synapse

API Version:: 2020-12-01

Fügen Sie den Inhalt an die Bibliotheksressource an, die mit dem Erstellungsvorgang erstellt wurde. Die maximale Inhaltsgröße beträgt 4MiB. Inhalte, die größer als 4MiB sind, müssen in 4MiB-Blöcken angefügt werden.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string uri	Der Endpunkt zur Arbeitsbereichsentwicklung, Beispiel: `https://myworkspace.dev.azuresynapse.net`
libraryName	path	True	string	Dateiname, der hochgeladen werden soll. Die Mindestlänge des Dateinamens sollte 1 ohne die Erweiterungslänge sein.
api-version	query	True	string	Die Synapse-Client-API-Version.
comp	query	True	string

Anforderungsheader

Media Types: "application/octet-stream"

Name	Erforderlich	Typ	Beschreibung
x-ms-blob-condition-appendpos		integer int64	Legen Sie diesen Header auf einen Byteoffset fest, bei dem erwartet wird, dass der Block angefügt wird. Die Anforderung ist nur erfolgreich, wenn der aktuelle Offset mit diesem Wert übereinstimmt. Andernfalls schlägt die Anforderung mit dem AppendPositionConditionNotMet-Fehler fehl (HTTP-status Code 412 – Vorbedingung fehlgeschlagen).

Anforderungstext

Media Types: "application/octet-stream"

Name	Typ	Beschreibung
content	string	Bibliotheksdateiblöcke.

Antworten

Name	Typ	Beschreibung
201 Created		Erstellt.
Other Status Codes	CloudError	Eine Fehlerantwort, die vom Azure Synapse-Dienst empfangen wurde.

Beispiele

Append Library

Sample Request

HTTP

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


"file binary chunk"

Sample Response

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

Definitionen

CloudError

Das -Objekt, das die Struktur einer Azure Synapse Fehlerantwort definiert.

Name	Typ	Beschreibung
error.code	string	Fehlercode
error.details	CloudError[]	Array mit zusätzlichen Fehlerdetails.
error.message	string	Fehlermeldung.
error.target	string	Eigenschaftsname/Pfad in der Anforderung, die einem Fehler zugeordnet ist.