DataLakePathClient class
Un DataLakePathClient représente une URL vers le chemin d’accès au stockage Azure (répertoire ou fichier).
- Extends
Constructeurs
Data |
Crée une instance de DataLakePathClient à partir de l’URL et du pipeline. |
Data |
Crée une instance de DataLakePathClient à partir de l’URL et des informations d’identification. |
Propriétés
file |
Nom du système de fichiers actuel. |
name | Nom du chemin d’accès actuel (répertoire ou fichier). |
Propriétés héritées
account |
|
credential | Par exemple, AnonymousCredential, StorageSharedKeyCredential ou toutes les informations d’identification du |
url | Valeur de chaîne d’URL encodée. |
Méthodes
create(Path |
Créez un répertoire ou un chemin d’accès. Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create |
create |
Créez un répertoire ou un fichier. Si la ressource existe déjà, elle n’est pas modifiée. Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create |
delete(boolean, Path |
Supprimez le chemin actuel (répertoire ou fichier). Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete |
delete |
Supprimez le chemin actuel (répertoire ou fichier) s’il existe. Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete |
exists(Path |
Retourne true si le fichier Data Lake représenté par ce client existe ; false dans le cas contraire. REMARQUE : utilisez cette fonction avec précaution, car un fichier existant peut être supprimé par d’autres clients ou applications. Inversement, de nouveaux fichiers peuvent être ajoutés par d’autres clients ou applications une fois cette fonction terminée. |
get |
Retourne les données de contrôle d’accès d’un chemin d’accès (répertoire du fichier). Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/getproperties |
get |
Obtenez un DataLakeLeaseClient qui gère les baux sur le chemin d’accès (répertoire ou fichier). |
get |
Retourne toutes les métadonnées définies par l’utilisateur, les propriétés HTTP standard et les propriétés système du chemin d’accès (répertoire ou fichier).
AVERTISSEMENT : L’objet Voir https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties |
move(string, Path |
Déplacer un répertoire ou un fichier dans le même système de fichiers. Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create |
move(string, string, Path |
Déplacer le répertoire ou le fichier vers un autre système de fichiers. Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create |
remove |
Supprime le Access Control sur un chemin d’accès et des sous-chemins. Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
set |
Définissez les données de contrôle d’accès pour un chemin d’accès (répertoire de fichier). Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
set |
Définit le Access Control sur un chemin d’accès et des sous-chemins. Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
set |
Définit les propriétés système sur le chemin d’accès (répertoire ou fichier). Si aucune valeur n’est fournie ou aucune valeur fournie pour les en-têtes HTTP d’objet blob spécifiés, ces en-têtes HTTP blob sans valeur sont effacés. Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties |
set |
Définit les métadonnées définies par l’utilisateur pour le chemin d’accès spécifié (répertoire du fichier) sous la forme d’une ou plusieurs paires nom-valeur. Si aucune option n’est fournie ou si aucune métadonnées n’est définie dans le paramètre, les métadonnées de chemin d’accès sont supprimées. Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata |
set |
Définit les autorisations de fichier sur un chemin d’accès. Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
to |
Convertissez DataLakePathClient actuel en DataLakeDirectoryClient si le chemin actuel est un répertoire. |
to |
Convertissez DataLakePathClient actuel en DataLakeFileClient si le chemin actuel est un fichier. |
update |
Modifie le Access Control sur un chemin et des sous-chemins. Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
Détails du constructeur
DataLakePathClient(string, Pipeline)
Crée une instance de DataLakePathClient à partir de l’URL et du pipeline.
new DataLakePathClient(url: string, pipeline: Pipeline)
Paramètres
- url
-
string
Chaîne cliente pointant vers le chemin d’accès du lac de données stockage Azure (répertoire ou fichier), telle que «https://myaccount.dfs.core.windows.net/filesystem/directory" ; ou « https://myaccount.dfs.core.windows.net/filesystem/file". Vous pouvez ajouter une signature d’accès partagé si vous utilisez AnonymousCredential, par exemple «https://myaccount.dfs.core.windows.net/filesystem/directory?sasString" ; ».
- pipeline
- Pipeline
Appelez newPipeline() pour créer un pipeline par défaut ou fournissez un pipeline personnalisé.
DataLakePathClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)
Crée une instance de DataLakePathClient à partir de l’URL et des informations d’identification.
new DataLakePathClient(url: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)
Paramètres
- url
-
string
Chaîne cliente pointant vers le chemin d’accès du lac de données stockage Azure (répertoire ou fichier), telle que «https://myaccount.dfs.core.windows.net/filesystem/directory" ; ou « https://myaccount.dfs.core.windows.net/filesystem/file". Vous pouvez ajouter une signature d’accès partagé si vous utilisez AnonymousCredential, par exemple «https://myaccount.dfs.core.windows.net/filesystem/directory?sasString" ; ».
- credential
-
StorageSharedKeyCredential | AnonymousCredential | TokenCredential
Par exemple, AnonymousCredential, StorageSharedKeyCredential ou toutes les informations d’identification du @azure/identity
package pour authentifier les demandes adressées au service. Vous pouvez également fournir un objet qui implémente l’interface TokenCredential. S’il n’est pas spécifié, AnonymousCredential est utilisé.
- options
- StoragePipelineOptions
facultatif. Options pour configurer le pipeline HTTP.
Détails de la propriété
fileSystemName
Nom du système de fichiers actuel.
string fileSystemName
Valeur de propriété
string
name
Nom du chemin d’accès actuel (répertoire ou fichier).
string name
Valeur de propriété
string
Détails de la propriété héritée
accountName
credential
Par exemple, AnonymousCredential, StorageSharedKeyCredential ou toutes les informations d’identification du @azure/identity
package pour authentifier les demandes adressées au service. Vous pouvez également fournir un objet qui implémente l’interface TokenCredential. S’il n’est pas spécifié, AnonymousCredential est utilisé.
credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential
Valeur de propriété
StorageSharedKeyCredential | AnonymousCredential | TokenCredential
Hérité deStorageClient.credential
url
Détails de la méthode
create(PathResourceTypeModel, PathCreateOptions)
Créez un répertoire ou un chemin d’accès.
Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
function create(resourceType: PathResourceTypeModel, options?: PathCreateOptions): Promise<PathCreateResponse>
Paramètres
- resourceType
- PathResourceTypeModel
Type de ressource, « répertoire » ou « fichier ».
- options
- PathCreateOptions
facultatif. Options lors de la création du chemin d’accès.
Retours
Promise<PathCreateResponse>
createIfNotExists(PathResourceTypeModel, PathCreateIfNotExistsOptions)
Créez un répertoire ou un fichier. Si la ressource existe déjà, elle n’est pas modifiée.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
function createIfNotExists(resourceType: PathResourceTypeModel, options?: PathCreateIfNotExistsOptions): Promise<PathCreateIfNotExistsResponse>
Paramètres
- resourceType
- PathResourceTypeModel
Type de ressource, « répertoire » ou « fichier ».
- options
- PathCreateIfNotExistsOptions
Retours
Promise<PathCreateIfNotExistsResponse>
delete(boolean, PathDeleteOptions)
Supprimez le chemin actuel (répertoire ou fichier).
Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete
function delete(recursive?: boolean, options?: PathDeleteOptions): Promise<PathDeleteResponse>
Paramètres
- recursive
-
boolean
Obligatoire et valide uniquement lorsque la ressource est un répertoire. Si « true », tous les chemins d’accès situés sous le répertoire seront supprimés.
- options
- PathDeleteOptions
facultatif. Options lors de la suppression du chemin d’accès.
Retours
Promise<PathDeleteResponse>
deleteIfExists(boolean, PathDeleteOptions)
Supprimez le chemin actuel (répertoire ou fichier) s’il existe.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete
function deleteIfExists(recursive?: boolean, options?: PathDeleteOptions): Promise<PathDeleteIfExistsResponse>
Paramètres
- recursive
-
boolean
Obligatoire et valide uniquement lorsque la ressource est un répertoire. Si « true », tous les chemins d’accès situés sous le répertoire seront supprimés.
- options
- PathDeleteOptions
Retours
Promise<PathDeleteIfExistsResponse>
exists(PathExistsOptions)
Retourne true si le fichier Data Lake représenté par ce client existe ; false dans le cas contraire. REMARQUE : utilisez cette fonction avec précaution, car un fichier existant peut être supprimé par d’autres clients ou applications. Inversement, de nouveaux fichiers peuvent être ajoutés par d’autres clients ou applications une fois cette fonction terminée.
function exists(options?: PathExistsOptions): Promise<boolean>
Paramètres
- options
- PathExistsOptions
options de l’opération Exists.
Retours
Promise<boolean>
getAccessControl(PathGetAccessControlOptions)
Retourne les données de contrôle d’accès d’un chemin d’accès (répertoire du fichier).
Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/getproperties
function getAccessControl(options?: PathGetAccessControlOptions): Promise<PathGetAccessControlResponse>
Paramètres
- options
- PathGetAccessControlOptions
facultatif. Options lors de l’obtention du contrôle d’accès aux fichiers.
Retours
Promise<PathGetAccessControlResponse>
getDataLakeLeaseClient(string)
Obtenez un DataLakeLeaseClient qui gère les baux sur le chemin d’accès (répertoire ou fichier).
function getDataLakeLeaseClient(proposeLeaseId?: string): DataLakeLeaseClient
Paramètres
- proposeLeaseId
-
string
facultatif. ID de bail initial proposé.
Retours
getProperties(PathGetPropertiesOptions)
Retourne toutes les métadonnées définies par l’utilisateur, les propriétés HTTP standard et les propriétés système du chemin d’accès (répertoire ou fichier).
AVERTISSEMENT : L’objet metadata
retourné dans la réponse aura ses clés en minuscules, même si elles contenaient à l’origine des caractères majuscules. Cela diffère des clés de métadonnées retournées par les méthodes de cette liste de chemins à l’aide de DataLakeFileSystemClient l’option includeMetadata
, qui conservera leur casse d’origine.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties
function getProperties(options?: PathGetPropertiesOptions): Promise<PathGetPropertiesResponse>
Paramètres
- options
- PathGetPropertiesOptions
facultatif. Options lors de l’obtention des propriétés de chemin d’accès.
Retours
Promise<PathGetPropertiesResponse>
move(string, PathMoveOptions)
Déplacer un répertoire ou un fichier dans le même système de fichiers.
Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
function move(destinationPath: string, options?: PathMoveOptions): Promise<PathMoveResponse>
Paramètres
- destinationPath
-
string
Chemin du répertoire de destination comme « répertoire » ou chemin de fichier « répertoire/fichier ». Si destinationPath est authentifié auprès de SAS, ajoutez la sap au chemin d’accès de destination, par exemple « répertoire/fichier?sasToken ».
- options
- PathMoveOptions
facultatif. Options lors du déplacement d’un répertoire ou d’un fichier.
Retours
Promise<PathMoveResponse>
move(string, string, PathMoveOptions)
Déplacer le répertoire ou le fichier vers un autre système de fichiers.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
function move(destinationFileSystem: string, destinationPath: string, options?: PathMoveOptions): Promise<PathMoveResponse>
Paramètres
- destinationFileSystem
-
string
Système de fichiers de destination comme « système de fichiers ».
- destinationPath
-
string
Chemin du répertoire de destination comme « répertoire » ou chemin de fichier « répertoire/fichier » Si le destinationPath est authentifié auprès de la sap, ajoutez la sap au chemin de destination, comme « répertoire/fichier?sasToken ».
- options
- PathMoveOptions
facultatif. Options lors du déplacement d’un répertoire ou d’un fichier.
Retours
Promise<PathMoveResponse>
removeAccessControlRecursive(RemovePathAccessControlItem[], PathChangeAccessControlRecursiveOptions)
Supprime le Access Control sur un chemin d’accès et des sous-chemins.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function removeAccessControlRecursive(acl: RemovePathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>
Paramètres
Liste de contrôle d’accès POSIX pour le fichier ou le répertoire.
facultatif. Options
Retours
setAccessControl(PathAccessControlItem[], PathSetAccessControlOptions)
Définissez les données de contrôle d’accès pour un chemin d’accès (répertoire de fichier).
Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function setAccessControl(acl: PathAccessControlItem[], options?: PathSetAccessControlOptions): Promise<PathSetAccessControlResponse>
Paramètres
- acl
Liste de contrôle d’accès POSIX pour le fichier ou le répertoire.
- options
- PathSetAccessControlOptions
facultatif. Options lors de la définition du contrôle d’accès au chemin d’accès.
Retours
Promise<PathSetAccessControlResponse>
setAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)
Définit le Access Control sur un chemin d’accès et des sous-chemins.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function setAccessControlRecursive(acl: PathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>
Paramètres
- acl
Liste de contrôle d’accès POSIX pour le fichier ou le répertoire.
facultatif. Options
Retours
setHttpHeaders(PathHttpHeaders, PathSetHttpHeadersOptions)
Définit les propriétés système sur le chemin d’accès (répertoire ou fichier). Si aucune valeur n’est fournie ou aucune valeur fournie pour les en-têtes HTTP d’objet blob spécifiés, ces en-têtes HTTP blob sans valeur sont effacés.
Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties
function setHttpHeaders(httpHeaders: PathHttpHeaders, options?: PathSetHttpHeadersOptions): Promise<PathSetHttpHeadersResponse>
Paramètres
- httpHeaders
- PathHttpHeaders
- options
- PathSetHttpHeadersOptions
Retours
Promise<PathSetHttpHeadersResponse>
setMetadata(Metadata, PathSetMetadataOptions)
Définit les métadonnées définies par l’utilisateur pour le chemin d’accès spécifié (répertoire du fichier) sous la forme d’une ou plusieurs paires nom-valeur. Si aucune option n’est fournie ou si aucune métadonnées n’est définie dans le paramètre, les métadonnées de chemin d’accès sont supprimées.
Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata
function setMetadata(metadata?: Metadata, options?: PathSetMetadataOptions): Promise<PathSetMetadataResponse>
Paramètres
- metadata
- Metadata
facultatif. Remplacez les métadonnées existantes par cette valeur. Si aucune valeur n’a été fournie, les métadonnées existantes seront supprimées.
- options
- PathSetMetadataOptions
facultatif. Options lors de la définition des métadonnées de chemin d’accès.
Retours
Promise<PathSetMetadataResponse>
setPermissions(PathPermissions, PathSetPermissionsOptions)
Définit les autorisations de fichier sur un chemin d’accès.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function setPermissions(permissions: PathPermissions, options?: PathSetPermissionsOptions): Promise<PathSetAccessControlResponse>
Paramètres
- permissions
- PathPermissions
Autorisations d’accès POSIX pour le propriétaire du fichier, le groupe propriétaire du fichier et d’autres.
- options
- PathSetPermissionsOptions
facultatif. Options lors de la définition des autorisations de chemin d’accès.
Retours
Promise<PathSetAccessControlResponse>
toDirectoryClient()
Convertissez DataLakePathClient actuel en DataLakeDirectoryClient si le chemin actuel est un répertoire.
function toDirectoryClient(): DataLakeDirectoryClient
Retours
toFileClient()
Convertissez DataLakePathClient actuel en DataLakeFileClient si le chemin actuel est un fichier.
function toFileClient(): DataLakeFileClient
Retours
updateAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)
Modifie le Access Control sur un chemin et des sous-chemins.
Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function updateAccessControlRecursive(acl: PathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>
Paramètres
- acl
Liste de contrôle d’accès POSIX pour le fichier ou le répertoire.
facultatif. Options