DataLakePathClient class
DataLakePathClient rappresenta un URL del percorso di Archiviazione di Azure (directory o file).
- Extends
-
StorageClient
Costruttori
Data |
Crea un'istanza di DataLakePathClient dall'URL e dalla pipeline. |
Data |
Crea un'istanza di DataLakePathClient dall'URL e dalle credenziali. |
Proprietà
file |
Nome del file system corrente. |
name | Nome del percorso corrente (directory o file). |
Proprietà ereditate
account |
|
credential | Ad esempio AnonymousCredential, StorageSharedKeyCredential o qualsiasi credenziale del |
url | Valore stringa URL codificato. |
Metodi
create(Path |
Creare una directory o un percorso. Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create |
create |
Creare una directory o un file. Se la risorsa esiste già, non viene modificata. Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create |
delete(boolean, Path |
Eliminare il percorso corrente (directory o file). Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete |
delete |
Eliminare il percorso corrente (directory o file) se esistente. Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete |
exists(Path |
Restituisce true se il file Data Lake rappresentato da questo client esiste; false in caso contrario. NOTA: usare questa funzione con attenzione perché un file esistente potrebbe essere eliminato da altri client o applicazioni. Viceversa, è possibile aggiungere nuovi file da altri client o applicazioni al termine di questa funzione. |
get |
Restituisce i dati di controllo di accesso per un percorso (directory di file). Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/getproperties |
get |
Ottenere un DataLakeLeaseClient che gestisce i lease nel percorso (directory o file). |
get |
Restituisce tutti i metadati definiti dall'utente, le proprietà HTTP standard e le proprietà di sistema per il percorso (directory o file). AVVISO: l'oggetto Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties |
move(string, Path |
Spostare la directory o il file all'interno dello stesso file system. Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create |
move(string, string, Path |
Spostare la directory o il file in un altro file system. Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create |
remove |
Rimuove il Controllo di accesso in un percorso e in percorsi secondari. Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
set |
Impostare i dati di controllo di accesso per un percorso (directory di file). Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
set |
Imposta la Controllo di accesso su un percorso e su percorsi secondari. Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
set |
Imposta le proprietà di sistema nel percorso (directory o file). Se non viene specificato alcun valore o nessun valore specificato per le intestazioni HTTP BLOB specificate, queste intestazioni HTTP BLOB senza un valore verranno cancellate. Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties |
set |
Imposta i metadati definiti dall'utente per il percorso specificato (directory del file) come una o più coppie nome-valore. Se non sono disponibili opzioni o nessun metadati definito nel parametro, i metadati del percorso verranno rimossi. Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata |
set |
Imposta le autorizzazioni per il file in un percorso. Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
to |
Convertire l'oggetto DataLakePathClient corrente in DataLakeDirectoryClient se il percorso corrente è una directory. |
to |
Convertire l'oggetto DataLakePathClient corrente in DataLakeFileClient se il percorso corrente è un file. |
update |
Modifica il Controllo di accesso in un percorso e in percorsi secondari. Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
Dettagli costruttore
DataLakePathClient(string, Pipeline)
Crea un'istanza di DataLakePathClient dall'URL e dalla pipeline.
new DataLakePathClient(url: string, pipeline: Pipeline)
Parametri
- url
-
string
Stringa client che punta al percorso data lake di Archiviazione di Azure (directory o file), ad esempio "https://myaccount.dfs.core.windows.net/filesystem/directory" o "https://myaccount.dfs.core.windows.net/filesystem/file". È possibile aggiungere una firma di accesso condiviso se si usa AnonymousCredential, ad esempio "https://myaccount.dfs.core.windows.net/filesystem/directory?sasString".
- pipeline
- Pipeline
Chiamare newPipeline() per creare una pipeline predefinita o fornire una pipeline personalizzata.
DataLakePathClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)
Crea un'istanza di DataLakePathClient dall'URL e dalle credenziali.
new DataLakePathClient(url: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)
Parametri
- url
-
string
Stringa client che punta al percorso data lake di Archiviazione di Azure (directory o file), ad esempio "https://myaccount.dfs.core.windows.net/filesystem/directory" o "https://myaccount.dfs.core.windows.net/filesystem/file". È possibile aggiungere una firma di accesso condiviso se si usa AnonymousCredential, ad esempio "https://myaccount.dfs.core.windows.net/filesystem/directory?sasString".
- credential
-
StorageSharedKeyCredential | AnonymousCredential | TokenCredential
Ad esempio AnonymousCredential, StorageSharedKeyCredential o qualsiasi credenziale del @azure/identity
pacchetto per autenticare le richieste al servizio. È anche possibile fornire un oggetto che implementa l'interfaccia TokenCredential. Se non specificato, viene utilizzato AnonymousCredential.
- options
- StoragePipelineOptions
Facoltativa. Opzioni per configurare la pipeline HTTP.
Dettagli proprietà
fileSystemName
Nome del file system corrente.
string fileSystemName
Valore della proprietà
string
name
Nome del percorso corrente (directory o file).
string name
Valore della proprietà
string
Dettagli proprietà ereditate
accountName
accountName: string
Valore della proprietà
string
Ereditato da StorageClient.accountName
credential
Ad esempio AnonymousCredential, StorageSharedKeyCredential o qualsiasi credenziale del @azure/identity
pacchetto per autenticare le richieste al servizio. È anche possibile fornire un oggetto che implementa l'interfaccia TokenCredential. Se non specificato, viene utilizzato AnonymousCredential.
credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential
Valore della proprietà
Ereditato da StorageClient.credential
url
Valore stringa URL codificato.
url: string
Valore della proprietà
string
Ereditato da StorageClient.url
Dettagli metodo
create(PathResourceTypeModel, PathCreateOptions)
Creare una directory o un percorso.
Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
function create(resourceType: PathResourceTypeModel, options?: PathCreateOptions): Promise<PathCreateResponse>
Parametri
- resourceType
- PathResourceTypeModel
Tipo di risorsa, "directory" o "file".
- options
- PathCreateOptions
Facoltativa. Opzioni durante la creazione del percorso.
Restituisce
Promise<PathCreateResponse>
createIfNotExists(PathResourceTypeModel, PathCreateIfNotExistsOptions)
Creare una directory o un file. Se la risorsa esiste già, non viene modificata.
Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
function createIfNotExists(resourceType: PathResourceTypeModel, options?: PathCreateIfNotExistsOptions): Promise<PathCreateIfNotExistsResponse>
Parametri
- resourceType
- PathResourceTypeModel
Tipo di risorsa, "directory" o "file".
- options
- PathCreateIfNotExistsOptions
Restituisce
Promise<PathCreateIfNotExistsResponse>
delete(boolean, PathDeleteOptions)
Eliminare il percorso corrente (directory o file).
Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete
function delete(recursive?: boolean, options?: PathDeleteOptions): Promise<PathDeleteResponse>
Parametri
- recursive
-
boolean
Obbligatorio e valido solo quando la risorsa è una directory. Se "true", tutti i percorsi sotto la directory verranno eliminati.
- options
- PathDeleteOptions
Facoltativa. Opzioni durante l'eliminazione del percorso.
Restituisce
Promise<PathDeleteResponse>
deleteIfExists(boolean, PathDeleteOptions)
Eliminare il percorso corrente (directory o file) se esistente.
Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete
function deleteIfExists(recursive?: boolean, options?: PathDeleteOptions): Promise<PathDeleteIfExistsResponse>
Parametri
- recursive
-
boolean
Obbligatorio e valido solo quando la risorsa è una directory. Se "true", tutti i percorsi sotto la directory verranno eliminati.
- options
- PathDeleteOptions
Restituisce
Promise<PathDeleteIfExistsResponse>
exists(PathExistsOptions)
Restituisce true se il file Data Lake rappresentato da questo client esiste; false in caso contrario.
NOTA: usare questa funzione con attenzione perché un file esistente potrebbe essere eliminato da altri client o applicazioni. Viceversa, è possibile aggiungere nuovi file da altri client o applicazioni al termine di questa funzione.
function exists(options?: PathExistsOptions): Promise<boolean>
Parametri
- options
- PathExistsOptions
opzioni per l'operazione Exists.
Restituisce
Promise<boolean>
getAccessControl(PathGetAccessControlOptions)
Restituisce i dati di controllo di accesso per un percorso (directory di file).
Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/getproperties
function getAccessControl(options?: PathGetAccessControlOptions): Promise<PathGetAccessControlResponse>
Parametri
- options
- PathGetAccessControlOptions
Facoltativa. Opzioni per ottenere il controllo di accesso ai file.
Restituisce
Promise<PathGetAccessControlResponse>
getDataLakeLeaseClient(string)
Ottenere un DataLakeLeaseClient che gestisce i lease nel percorso (directory o file).
function getDataLakeLeaseClient(proposeLeaseId?: string): DataLakeLeaseClient
Parametri
- proposeLeaseId
-
string
Facoltativa. ID lease proposto iniziale.
Restituisce
getProperties(PathGetPropertiesOptions)
Restituisce tutti i metadati definiti dall'utente, le proprietà HTTP standard e le proprietà di sistema per il percorso (directory o file).
AVVISO: l'oggetto metadata
restituito nella risposta avrà le chiavi in lettere minuscole, anche se in origine contengono caratteri maiuscoli. Questo comportamento è diverso dalle chiavi di metadati restituite dai metodi di DataLakeFileSystemClient che elencano i percorsi usando l'opzione , che manterrà la includeMetadata
combinazione di maiuscole e minuscole originali.
Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties
function getProperties(options?: PathGetPropertiesOptions): Promise<PathGetPropertiesResponse>
Parametri
- options
- PathGetPropertiesOptions
Facoltativa. Opzioni per ottenere le proprietà del percorso.
Restituisce
Promise<PathGetPropertiesResponse>
move(string, PathMoveOptions)
Spostare la directory o il file all'interno dello stesso file system.
Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
function move(destinationPath: string, options?: PathMoveOptions): Promise<PathMoveResponse>
Parametri
- destinationPath
-
string
Percorso della directory di destinazione, ad esempio "directory" o percorso file "directory/file". Se destinationPath viene autenticato con la firma di accesso condiviso, aggiungere la firma di accesso condiviso al percorso di destinazione, ad esempio "directory/file?sasToken".
- options
- PathMoveOptions
Facoltativa. Opzioni durante lo spostamento di directory o file.
Restituisce
Promise<PathMoveResponse>
move(string, string, PathMoveOptions)
Spostare la directory o il file in un altro file system.
Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
function move(destinationFileSystem: string, destinationPath: string, options?: PathMoveOptions): Promise<PathMoveResponse>
Parametri
- destinationFileSystem
-
string
File system di destinazione, ad esempio "file system".
- destinationPath
-
string
Percorso della directory di destinazione, ad esempio "directory" o percorso file "directory/file" Se destinationPath è autenticato con la firma di accesso condiviso, aggiungere la firma di accesso condiviso al percorso di destinazione, ad esempio "directory/file?sasToken".
- options
- PathMoveOptions
Facoltativa. Opzioni durante lo spostamento di directory o file.
Restituisce
Promise<PathMoveResponse>
removeAccessControlRecursive(RemovePathAccessControlItem[], PathChangeAccessControlRecursiveOptions)
Rimuove il Controllo di accesso in un percorso e in percorsi secondari.
Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function removeAccessControlRecursive(acl: RemovePathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>
Parametri
Elenco di controllo di accesso POSIX per il file o la directory.
Facoltativa. Opzioni
Restituisce
setAccessControl(PathAccessControlItem[], PathSetAccessControlOptions)
Impostare i dati di controllo di accesso per un percorso (directory di file).
Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function setAccessControl(acl: PathAccessControlItem[], options?: PathSetAccessControlOptions): Promise<PathSetAccessControlResponse>
Parametri
- acl
Elenco di controllo di accesso POSIX per il file o la directory.
- options
- PathSetAccessControlOptions
Facoltativa. Opzioni quando si imposta il controllo di accesso del percorso.
Restituisce
Promise<PathSetAccessControlResponse>
setAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)
Imposta la Controllo di accesso su un percorso e su percorsi secondari.
Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function setAccessControlRecursive(acl: PathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>
Parametri
- acl
Elenco di controllo di accesso POSIX per il file o la directory.
Facoltativa. Opzioni
Restituisce
setHttpHeaders(PathHttpHeaders, PathSetHttpHeadersOptions)
Imposta le proprietà di sistema nel percorso (directory o file).
Se non viene specificato alcun valore o nessun valore specificato per le intestazioni HTTP BLOB specificate, queste intestazioni HTTP BLOB senza un valore verranno cancellate.
Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties
function setHttpHeaders(httpHeaders: PathHttpHeaders, options?: PathSetHttpHeadersOptions): Promise<PathSetHttpHeadersResponse>
Parametri
- httpHeaders
- PathHttpHeaders
- options
- PathSetHttpHeadersOptions
Restituisce
Promise<PathSetHttpHeadersResponse>
setMetadata(Metadata, PathSetMetadataOptions)
Imposta i metadati definiti dall'utente per il percorso specificato (directory del file) come una o più coppie nome-valore.
Se non sono disponibili opzioni o nessun metadati definito nel parametro, i metadati del percorso verranno rimossi.
Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata
function setMetadata(metadata?: Metadata, options?: PathSetMetadataOptions): Promise<PathSetMetadataResponse>
Parametri
- metadata
- Metadata
Facoltativa. Sostituire i metadati esistenti con questo valore. Se non viene specificato alcun valore, i metadati esistenti verranno rimossi.
- options
- PathSetMetadataOptions
Facoltativa. Opzioni durante l'impostazione dei metadati del percorso.
Restituisce
Promise<PathSetMetadataResponse>
setPermissions(PathPermissions, PathSetPermissionsOptions)
Imposta le autorizzazioni per il file in un percorso.
Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function setPermissions(permissions: PathPermissions, options?: PathSetPermissionsOptions): Promise<PathSetPermissionsResponse>
Parametri
- permissions
- PathPermissions
Autorizzazioni di accesso POSIX per il proprietario del file, il gruppo proprietario del file e altri.
- options
- PathSetPermissionsOptions
Facoltativa. Opzioni quando si impostano le autorizzazioni per il percorso.
Restituisce
Promise<PathSetPermissionsResponse>
toDirectoryClient()
Convertire l'oggetto DataLakePathClient corrente in DataLakeDirectoryClient se il percorso corrente è una directory.
function toDirectoryClient(): DataLakeDirectoryClient
Restituisce
toFileClient()
Convertire l'oggetto DataLakePathClient corrente in DataLakeFileClient se il percorso corrente è un file.
function toFileClient(): DataLakeFileClient
Restituisce
updateAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)
Modifica il Controllo di accesso in un percorso e in percorsi secondari.
Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function updateAccessControlRecursive(acl: PathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>
Parametri
- acl
Elenco di controllo di accesso POSIX per il file o la directory.
Facoltativa. Opzioni