Freigeben über


DataLakePathClient class

Ein DataLakePathClient stellt eine URL zum Azure Storage-Pfad (Verzeichnis oder Datei) dar.

Extends

StorageClient

Konstruktoren

DataLakePathClient(string, Pipeline)

Erstellt eine Instanz von DataLakePathClient aus url und Pipeline.

DataLakePathClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Erstellt eine Instanz von DataLakePathClient aus URL und Anmeldeinformationen.

Eigenschaften

fileSystemName

Name des aktuellen Dateisystems.

name

Name des aktuellen Pfads (Verzeichnis oder Datei).

Geerbte Eigenschaften

accountName
credential

Wie anonyme Anmeldeinformationen, StorageSharedKeyCredential oder anmeldeinformationen aus dem @azure/identity-Paket zum Authentifizieren von Anforderungen an den Dienst. Sie können auch ein Objekt bereitstellen, das die TokenCredential-Schnittstelle implementiert. Wenn nicht angegeben, wird AnonymousCredential verwendet.

url

Codierter URL-Zeichenfolgenwert.

Methoden

create(PathResourceType, PathCreateOptions)

Erstellen Eines Verzeichnisses oder Pfads.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create

createIfNotExists(PathResourceType, PathCreateIfNotExistsOptions)

Erstellen Sie ein Verzeichnis oder eine Datei. Wenn die Ressource bereits vorhanden ist, wird sie nicht geändert.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create

delete(boolean, PathDeleteOptions)

Aktuellen Pfad löschen (Verzeichnis oder Datei).

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/delete

deleteIfExists(boolean, PathDeleteOptions)

Löschen Sie den aktuellen Pfad (Verzeichnis oder Datei), falls vorhanden.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/delete

exists(PathExistsOptions)

Gibt true zurück, wenn die Data Lake-Datei, die durch diesen Client dargestellt wird, vorhanden ist; andernfalls "false".

HINWEIS: Verwenden Sie diese Funktion sorgfältig, da eine vorhandene Datei möglicherweise von anderen Clients oder Anwendungen gelöscht wird. Umgekehrt können neue Dateien von anderen Clients oder Anwendungen hinzugefügt werden, nachdem diese Funktion abgeschlossen wurde.

getAccessControl(PathGetAccessControlOptions)

Gibt die Zugriffssteuerungsdaten für einen Pfad (Verzeichnis der Datei) zurück.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/getproperties

getDataLakeLeaseClient(string)

Rufen Sie eine DataLakeLeaseClient- ab, die Leases für den Pfad (Verzeichnis oder Datei) verwaltet.

getProperties(PathGetPropertiesOptions)

Gibt alle benutzerdefinierten Metadaten, Standard-HTTP-Eigenschaften und Systemeigenschaften für den Pfad (Verzeichnis oder Datei) zurück.

WARNUNG: Das in der Antwort zurückgegebene metadata-Objekt weist die Schlüssel in Kleinbuchstaben auf, auch wenn sie ursprünglich Großbuchstaben enthielten. Dies unterscheidet sich von den Metadatenschlüsseln, die von den Methoden von DataLakeFileSystemClient, die Pfade mithilfe der Option includeMetadata auflisten, die ihre ursprüngliche Groß-/Kleinschreibung beibehalten.

Siehe https://learn.microsoft.com/rest/api/storageservices/get-blob-properties

move(string, PathMoveOptions)

Verschieben sie das Verzeichnis oder die Datei innerhalb desselben Dateisystems.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create

move(string, string, PathMoveOptions)

Verschieben sie das Verzeichnis oder die Datei in ein anderes Dateisystem.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create

removeAccessControlRecursive(RemovePathAccessControlItem[], PathChangeAccessControlRecursiveOptions)

Entfernt die Zugriffssteuerung für einen Pfad und Unterpfad.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update

setAccessControl(PathAccessControlItem[], PathSetAccessControlOptions)

Legen Sie die Zugriffssteuerungsdaten für einen Pfad (Verzeichnis der Datei) fest.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update

setAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)

Legt die Zugriffssteuerung für einen Pfad und Unterpfad fest.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update

setHttpHeaders(PathHttpHeaders, PathSetHttpHeadersOptions)

Legt Systemeigenschaften für den Pfad (Verzeichnis oder Datei) fest.

Wenn kein Wert angegeben oder kein Wert für die angegebenen BLOB-HTTP-Header bereitgestellt wird, werden diese BLOB-HTTP-Header ohne einen Wert gelöscht.

Siehe https://learn.microsoft.com/rest/api/storageservices/set-blob-properties

setMetadata(Metadata, PathSetMetadataOptions)

Legt benutzerdefinierte Metadaten für den angegebenen Pfad (Verzeichnis der Datei) als ein oder mehrere Name-Wert-Paare fest.

Wenn im Parameter keine Option angegeben oder keine Metadaten definiert sind, werden die Pfadmetadaten entfernt.

Siehe https://learn.microsoft.com/rest/api/storageservices/set-blob-metadata

setPermissions(PathPermissions, PathSetPermissionsOptions)

Legt die Dateiberechtigungen für einen Pfad fest.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update

toDirectoryClient()

Konvertieren Sie den aktuellen DataLakePathClient in DataLakeDirectoryClient, wenn der aktuelle Pfad ein Verzeichnis ist.

toFileClient()

Konvertieren Sie den aktuellen DataLakePathClient in DataLakeFileClient, wenn der aktuelle Pfad eine Datei ist.

updateAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)

Ändert die Zugriffssteuerung für einen Pfad und Unterpfad.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update

Details zum Konstruktor

DataLakePathClient(string, Pipeline)

Erstellt eine Instanz von DataLakePathClient aus url und Pipeline.

new DataLakePathClient(url: string, pipeline: Pipeline)

Parameter

url

string

Eine Clientzeichenfolge, die auf den Azure Storage Data Lake-Pfad (Verzeichnis oder Datei) verweist, z. B. "https://myaccount.dfs.core.windows.net/filesystem/directory" oder "https://myaccount.dfs.core.windows.net/filesystem/file". Sie können eine SAS anfügen, wenn Anonyme Anmeldeinformationen verwendet werden, z. B. "https://myaccount.dfs.core.windows.net/filesystem/directory?sasString".

pipeline
Pipeline

Rufen Sie newPipeline() auf, um eine Standardpipeline zu erstellen oder eine angepasste Pipeline bereitzustellen.

DataLakePathClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Erstellt eine Instanz von DataLakePathClient aus URL und Anmeldeinformationen.

new DataLakePathClient(url: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)

Parameter

url

string

Eine Clientzeichenfolge, die auf den Azure Storage Data Lake-Pfad (Verzeichnis oder Datei) verweist, z. B. "https://myaccount.dfs.core.windows.net/filesystem/directory" oder "https://myaccount.dfs.core.windows.net/filesystem/file". Sie können eine SAS anfügen, wenn Anonyme Anmeldeinformationen verwendet werden, z. B. "https://myaccount.dfs.core.windows.net/filesystem/directory?sasString".

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Wie anonyme Anmeldeinformationen, StorageSharedKeyCredential oder anmeldeinformationen aus dem @azure/identity-Paket zum Authentifizieren von Anforderungen an den Dienst. Sie können auch ein Objekt bereitstellen, das die TokenCredential-Schnittstelle implementiert. Wenn nicht angegeben, wird AnonymousCredential verwendet.

options
StoragePipelineOptions

Optional. Optionen zum Konfigurieren der HTTP-Pipeline.

Details zur Eigenschaft

fileSystemName

Name des aktuellen Dateisystems.

string fileSystemName

Eigenschaftswert

string

name

Name des aktuellen Pfads (Verzeichnis oder Datei).

string name

Eigenschaftswert

string

Geerbte Eigenschaftsdetails

accountName

accountName: string

Eigenschaftswert

string

geerbt von StorageClient.accountName

credential

Wie anonyme Anmeldeinformationen, StorageSharedKeyCredential oder anmeldeinformationen aus dem @azure/identity-Paket zum Authentifizieren von Anforderungen an den Dienst. Sie können auch ein Objekt bereitstellen, das die TokenCredential-Schnittstelle implementiert. Wenn nicht angegeben, wird AnonymousCredential verwendet.

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Eigenschaftswert

von StorageClient.credential geerbt

url

Codierter URL-Zeichenfolgenwert.

url: string

Eigenschaftswert

string

geerbt von StorageClient.url

Details zur Methode

create(PathResourceType, PathCreateOptions)

Erstellen Eines Verzeichnisses oder Pfads.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create

function create(resourceType: PathResourceType, options?: PathCreateOptions): Promise<PathCreateResponse>

Parameter

resourceType
PathResourceTypeModel

Ressourcentyp, "Verzeichnis" oder "Datei".

options
PathCreateOptions

Optional. Optionen beim Erstellen des Pfads.

Gibt zurück

createIfNotExists(PathResourceType, PathCreateIfNotExistsOptions)

Erstellen Sie ein Verzeichnis oder eine Datei. Wenn die Ressource bereits vorhanden ist, wird sie nicht geändert.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create

function createIfNotExists(resourceType: PathResourceType, options?: PathCreateIfNotExistsOptions): Promise<PathCreateIfNotExistsResponse>

Parameter

resourceType
PathResourceTypeModel

Ressourcentyp, "Verzeichnis" oder "Datei".

Gibt zurück

delete(boolean, PathDeleteOptions)

Aktuellen Pfad löschen (Verzeichnis oder Datei).

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/delete

function delete(recursive?: boolean, options?: PathDeleteOptions): Promise<PathDeleteResponse>

Parameter

recursive

boolean

Erforderlich und nur gültig, wenn die Ressource ein Verzeichnis ist. Wenn "true", werden alle Pfade unterhalb des Verzeichnisses gelöscht.

options
PathDeleteOptions

Optional. Optionen beim Löschen des Pfads.

Gibt zurück

deleteIfExists(boolean, PathDeleteOptions)

Löschen Sie den aktuellen Pfad (Verzeichnis oder Datei), falls vorhanden.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/delete

function deleteIfExists(recursive?: boolean, options?: PathDeleteOptions): Promise<PathDeleteIfExistsResponse>

Parameter

recursive

boolean

Erforderlich und nur gültig, wenn die Ressource ein Verzeichnis ist. Wenn "true", werden alle Pfade unterhalb des Verzeichnisses gelöscht.

Gibt zurück

exists(PathExistsOptions)

Gibt true zurück, wenn die Data Lake-Datei, die durch diesen Client dargestellt wird, vorhanden ist; andernfalls "false".

HINWEIS: Verwenden Sie diese Funktion sorgfältig, da eine vorhandene Datei möglicherweise von anderen Clients oder Anwendungen gelöscht wird. Umgekehrt können neue Dateien von anderen Clients oder Anwendungen hinzugefügt werden, nachdem diese Funktion abgeschlossen wurde.

function exists(options?: PathExistsOptions): Promise<boolean>

Parameter

options
PathExistsOptions

Optionen für den Betrieb Exists.

Gibt zurück

Promise<boolean>

getAccessControl(PathGetAccessControlOptions)

Gibt die Zugriffssteuerungsdaten für einen Pfad (Verzeichnis der Datei) zurück.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/getproperties

function getAccessControl(options?: PathGetAccessControlOptions): Promise<PathGetAccessControlResponse>

Parameter

options
PathGetAccessControlOptions

Optional. Optionen beim Abrufen der Dateizugriffskontrolle.

Gibt zurück

getDataLakeLeaseClient(string)

Rufen Sie eine DataLakeLeaseClient- ab, die Leases für den Pfad (Verzeichnis oder Datei) verwaltet.

function getDataLakeLeaseClient(proposeLeaseId?: string): DataLakeLeaseClient

Parameter

proposeLeaseId

string

Optional. Anfänglich vorgeschlagene Lease-ID.

Gibt zurück

getProperties(PathGetPropertiesOptions)

Gibt alle benutzerdefinierten Metadaten, Standard-HTTP-Eigenschaften und Systemeigenschaften für den Pfad (Verzeichnis oder Datei) zurück.

WARNUNG: Das in der Antwort zurückgegebene metadata-Objekt weist die Schlüssel in Kleinbuchstaben auf, auch wenn sie ursprünglich Großbuchstaben enthielten. Dies unterscheidet sich von den Metadatenschlüsseln, die von den Methoden von DataLakeFileSystemClient, die Pfade mithilfe der Option includeMetadata auflisten, die ihre ursprüngliche Groß-/Kleinschreibung beibehalten.

Siehe https://learn.microsoft.com/rest/api/storageservices/get-blob-properties

function getProperties(options?: PathGetPropertiesOptions): Promise<PathGetPropertiesResponse>

Parameter

options
PathGetPropertiesOptions

Optional. Optionen beim Abrufen von Pfadeigenschaften.

Gibt zurück

move(string, PathMoveOptions)

Verschieben sie das Verzeichnis oder die Datei innerhalb desselben Dateisystems.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create

function move(destinationPath: string, options?: PathMoveOptions): Promise<PathMoveResponse>

Parameter

destinationPath

string

Zielverzeichnispfad wie "Verzeichnis" oder Dateipfad "Verzeichnis/Datei". Wenn der destinationPath mit SAS authentifiziert ist, fügen Sie die SAS dem Zielpfad wie "directory/file?sasToken" hinzu.

options
PathMoveOptions

Optional. Optionen beim Verschieben des Verzeichnisses oder der Datei.

Gibt zurück

Promise<PathMoveResponse>

move(string, string, PathMoveOptions)

Verschieben sie das Verzeichnis oder die Datei in ein anderes Dateisystem.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create

function move(destinationFileSystem: string, destinationPath: string, options?: PathMoveOptions): Promise<PathMoveResponse>

Parameter

destinationFileSystem

string

Zieldateisystem wie "Filesystem".

destinationPath

string

Zielverzeichnispfad wie "Verzeichnis" oder Dateipfad "verzeichnis/datei" Wenn der Zielpfad bei SAS authentifiziert ist, fügen Sie die SAS dem Zielpfad wie "directory/file?sasToken" hinzu.

options
PathMoveOptions

Optional. Optionen beim Verschieben des Verzeichnisses oder der Datei.

Gibt zurück

Promise<PathMoveResponse>

removeAccessControlRecursive(RemovePathAccessControlItem[], PathChangeAccessControlRecursiveOptions)

Entfernt die Zugriffssteuerung für einen Pfad und Unterpfad.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update

function removeAccessControlRecursive(acl: RemovePathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>

Parameter

acl

RemovePathAccessControlItem[]

Die POSIX-Zugriffssteuerungsliste für die Datei oder das Verzeichnis.

options
PathChangeAccessControlRecursiveOptions

Optional. Options

Gibt zurück

setAccessControl(PathAccessControlItem[], PathSetAccessControlOptions)

Legen Sie die Zugriffssteuerungsdaten für einen Pfad (Verzeichnis der Datei) fest.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update

function setAccessControl(acl: PathAccessControlItem[], options?: PathSetAccessControlOptions): Promise<PathSetAccessControlResponse>

Parameter

acl

PathAccessControlItem[]

Die POSIX-Zugriffssteuerungsliste für die Datei oder das Verzeichnis.

options
PathSetAccessControlOptions

Optional. Optionen beim Festlegen der Pfadzugriffssteuerung.

Gibt zurück

setAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)

Legt die Zugriffssteuerung für einen Pfad und Unterpfad fest.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update

function setAccessControlRecursive(acl: PathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>

Parameter

acl

PathAccessControlItem[]

Die POSIX-Zugriffssteuerungsliste für die Datei oder das Verzeichnis.

options
PathChangeAccessControlRecursiveOptions

Optional. Options

Gibt zurück

setHttpHeaders(PathHttpHeaders, PathSetHttpHeadersOptions)

Legt Systemeigenschaften für den Pfad (Verzeichnis oder Datei) fest.

Wenn kein Wert angegeben oder kein Wert für die angegebenen BLOB-HTTP-Header bereitgestellt wird, werden diese BLOB-HTTP-Header ohne einen Wert gelöscht.

Siehe https://learn.microsoft.com/rest/api/storageservices/set-blob-properties

function setHttpHeaders(httpHeaders: PathHttpHeaders, options?: PathSetHttpHeadersOptions): Promise<PathSetHttpHeadersResponse>

Parameter

httpHeaders
PathHttpHeaders

Gibt zurück

setMetadata(Metadata, PathSetMetadataOptions)

Legt benutzerdefinierte Metadaten für den angegebenen Pfad (Verzeichnis der Datei) als ein oder mehrere Name-Wert-Paare fest.

Wenn im Parameter keine Option angegeben oder keine Metadaten definiert sind, werden die Pfadmetadaten entfernt.

Siehe https://learn.microsoft.com/rest/api/storageservices/set-blob-metadata

function setMetadata(metadata?: Metadata, options?: PathSetMetadataOptions): Promise<PathSetMetadataResponse>

Parameter

metadata
Metadata

Optional. Ersetzen Sie vorhandene Metadaten durch diesen Wert. Wenn kein Wert bereitgestellt wird, werden die vorhandenen Metadaten entfernt.

options
PathSetMetadataOptions

Optional. Optionen beim Festlegen von Pfadmetadaten.

Gibt zurück

setPermissions(PathPermissions, PathSetPermissionsOptions)

Legt die Dateiberechtigungen für einen Pfad fest.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update

function setPermissions(permissions: PathPermissions, options?: PathSetPermissionsOptions): Promise<PathSetPermissionsResponse>

Parameter

permissions
PathPermissions

Die POSIX-Zugriffsberechtigungen für den Dateibesitzer, die Besitzergruppe der Datei und andere.

options
PathSetPermissionsOptions

Optional. Optionen beim Festlegen von Pfadberechtigungen.

Gibt zurück

toDirectoryClient()

Konvertieren Sie den aktuellen DataLakePathClient in DataLakeDirectoryClient, wenn der aktuelle Pfad ein Verzeichnis ist.

function toDirectoryClient(): DataLakeDirectoryClient

Gibt zurück

toFileClient()

Konvertieren Sie den aktuellen DataLakePathClient in DataLakeFileClient, wenn der aktuelle Pfad eine Datei ist.

function toFileClient(): DataLakeFileClient

Gibt zurück

updateAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)

Ändert die Zugriffssteuerung für einen Pfad und Unterpfad.

Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update

function updateAccessControlRecursive(acl: PathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>

Parameter

acl

PathAccessControlItem[]

Die POSIX-Zugriffssteuerungsliste für die Datei oder das Verzeichnis.

options
PathChangeAccessControlRecursiveOptions

Optional. Options

Gibt zurück