DataLakePathClient class
Ein DataLakePathClient stellt eine URL zum Azure Storage-Pfad (Verzeichnis oder Datei) dar.
- Extends
-
StorageClient
Konstruktoren
| Data |
Erstellt eine Instanz von DataLakePathClient aus url und Pipeline. |
| Data |
Erstellt eine Instanz von DataLakePathClient aus URL und Anmeldeinformationen. |
Eigenschaften
| file |
Name des aktuellen Dateisystems. |
| name | Name des aktuellen Pfads (Verzeichnis oder Datei). |
Geerbte Eigenschaften
| account |
|
| credential | Wie anonyme Anmeldeinformationen, StorageSharedKeyCredential oder anmeldeinformationen aus dem |
| url | Codierter URL-Zeichenfolgenwert. |
Methoden
| create(Path |
Erstellen Eines Verzeichnisses oder Pfads. Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create |
| create |
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, Path |
Aktuellen Pfad löschen (Verzeichnis oder Datei). Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/delete |
| delete |
Löschen Sie den aktuellen Pfad (Verzeichnis oder Datei), falls vorhanden. Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/delete |
| exists(Path |
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. |
| get |
Gibt die Zugriffssteuerungsdaten für einen Pfad (Verzeichnis der Datei) zurück. Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/getproperties |
| get |
Rufen Sie eine DataLakeLeaseClient- ab, die Leases für den Pfad (Verzeichnis oder Datei) verwaltet. |
| get |
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 Siehe https://learn.microsoft.com/rest/api/storageservices/get-blob-properties |
| move(string, Path |
Verschieben sie das Verzeichnis oder die Datei innerhalb desselben Dateisystems. Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create |
| move(string, string, Path |
Verschieben sie das Verzeichnis oder die Datei in ein anderes Dateisystem. Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create |
| remove |
Entfernt die Zugriffssteuerung für einen Pfad und Unterpfad. Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update |
| set |
Legen Sie die Zugriffssteuerungsdaten für einen Pfad (Verzeichnis der Datei) fest. Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update |
| set |
Legt die Zugriffssteuerung für einen Pfad und Unterpfad fest. Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update |
| set |
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 |
| set |
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 |
| set |
Legt die Dateiberechtigungen für einen Pfad fest. Siehe https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update |
| to |
Konvertieren Sie den aktuellen DataLakePathClient in DataLakeDirectoryClient, wenn der aktuelle Pfad ein Verzeichnis ist. |
| to |
Konvertieren Sie den aktuellen DataLakePathClient in DataLakeFileClient, wenn der aktuelle Pfad eine Datei ist. |
| update |
Ä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
Promise<PathCreateResponse>
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".
- options
- PathCreateIfNotExistsOptions
Gibt zurück
Promise<PathCreateIfNotExistsResponse>
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
Promise<PathDeleteResponse>
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.
- options
- PathDeleteOptions
Gibt zurück
Promise<PathDeleteIfExistsResponse>
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
Promise<PathGetAccessControlResponse>
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
Promise<PathGetPropertiesResponse>
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
Die POSIX-Zugriffssteuerungsliste für die Datei oder das Verzeichnis.
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
Die POSIX-Zugriffssteuerungsliste für die Datei oder das Verzeichnis.
- options
- PathSetAccessControlOptions
Optional. Optionen beim Festlegen der Pfadzugriffssteuerung.
Gibt zurück
Promise<PathSetAccessControlResponse>
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
Die POSIX-Zugriffssteuerungsliste für die Datei oder das Verzeichnis.
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
- options
- PathSetHttpHeadersOptions
Gibt zurück
Promise<PathSetHttpHeadersResponse>
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
Promise<PathSetMetadataResponse>
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
Promise<PathSetPermissionsResponse>
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
Die POSIX-Zugriffssteuerungsliste für die Datei oder das Verzeichnis.
Optional. Options