DataLakePathClient class
Um DataLakePathClient representa uma URL para o caminho do Armazenamento do Azure (diretório ou arquivo).
- Extends
-
StorageClient
Construtores
| Data |
Cria uma instância de DataLakePathClient da URL e do pipeline. |
| Data |
Cria uma instância de DataLakePathClient com base na URL e na credencial. |
Propriedades
| file |
Nome do sistema de arquivos atual. |
| name | Nome do caminho atual (diretório ou arquivo). |
Propriedades herdadas
| account |
|
| credential | Como AnonymousCredential, StorageSharedKeyCredential ou qualquer credencial do pacote |
| url | Valor da cadeia de caracteres de URL codificada. |
Métodos
| create(Path |
Crie um diretório ou caminho. Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create |
| create |
Crie um diretório ou arquivo. Se o recurso já existir, ele não será alterado. Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create |
| delete(boolean, Path |
Excluir o caminho atual (diretório ou arquivo). Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/delete |
| delete |
Exclua o caminho atual (diretório ou arquivo) se ele existir. Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/delete |
| exists(Path |
Retornará true se o arquivo Data Lake representado por esse cliente existir; false caso contrário. OBSERVAÇÃO: use essa função com cuidado, pois um arquivo existente pode ser excluído por outros clientes ou aplicativos. Vice-versa, novos arquivos podem ser adicionados por outros clientes ou aplicativos após a conclusão dessa função. |
| get |
Retorna os dados de controle de acesso para um caminho (diretório do arquivo). Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/getproperties |
| get |
Obtenha um DataLakeLeaseClient que gerencia as concessões no caminho (diretório ou arquivo). |
| get |
Retorna todos os metadados definidos pelo usuário, as propriedades HTTP padrão e as propriedades do sistema para o caminho (diretório ou arquivo). AVISO: O objeto Consulte https://learn.microsoft.com/rest/api/storageservices/get-blob-properties |
| move(string, Path |
Mover diretório ou arquivo no mesmo sistema de arquivos. Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create |
| move(string, string, Path |
Mova o diretório ou o arquivo para outro sistema de arquivos. Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create |
| remove |
Remove o Controle de Acesso em um caminho e sub-caminhos. Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update |
| set |
Defina os dados de controle de acesso para um caminho (diretório do arquivo). Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update |
| set |
Define o Controle de Acesso em um caminho e sub-caminhos. Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update |
| set |
Define as propriedades do sistema no caminho (diretório ou arquivo). Se nenhum valor for fornecido ou nenhum valor fornecido para os cabeçalhos HTTP de blob especificados, esses cabeçalhos HTTP de blob sem um valor serão limpos. Consulte https://learn.microsoft.com/rest/api/storageservices/set-blob-properties |
| set |
Define metadados definidos pelo usuário para o caminho especificado (diretório do arquivo) como um ou mais pares nome-valor. Se nenhuma opção for fornecida ou nenhum metadados definido no parâmetro, os metadados do caminho serão removidos. Consulte https://learn.microsoft.com/rest/api/storageservices/set-blob-metadata |
| set |
Define as permissões de arquivo em um caminho. Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update |
| to |
Converta DataLakePathClient atual em DataLakeDirectoryClient se o caminho atual for um diretório. |
| to |
Converta DataLakePathClient atual em DataLakeFileClient se o caminho atual for um arquivo. |
| update |
Modifica o Controle de Acesso em um caminho e sub-caminhos. Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update |
Detalhes do construtor
DataLakePathClient(string, Pipeline)
Cria uma instância de DataLakePathClient da URL e do pipeline.
new DataLakePathClient(url: string, pipeline: Pipeline)
Parâmetros
- url
-
string
Uma cadeia de caracteres do cliente apontando para o caminho do data lake do Armazenamento do Azure (diretório ou arquivo), como "https://myaccount.dfs.core.windows.net/filesystem/directory" ou "https://myaccount.dfs.core.windows.net/filesystem/file". Você pode acrescentar uma SAS se estiver usando AnonymousCredential, como "https://myaccount.dfs.core.windows.net/filesystem/directory?sasString".
- pipeline
- Pipeline
Chame newPipeline() para criar um pipeline padrão ou forneça um pipeline personalizado.
DataLakePathClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)
Cria uma instância de DataLakePathClient com base na URL e na credencial.
new DataLakePathClient(url: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)
Parâmetros
- url
-
string
Uma cadeia de caracteres do cliente apontando para o caminho do data lake do Armazenamento do Azure (diretório ou arquivo), como "https://myaccount.dfs.core.windows.net/filesystem/directory" ou "https://myaccount.dfs.core.windows.net/filesystem/file". Você pode acrescentar uma SAS se estiver usando AnonymousCredential, como "https://myaccount.dfs.core.windows.net/filesystem/directory?sasString".
- credential
-
StorageSharedKeyCredential | AnonymousCredential | TokenCredential
Como AnonymousCredential, StorageSharedKeyCredential ou qualquer credencial do pacote @azure/identity para autenticar solicitações para o serviço. Você também pode fornecer um objeto que implementa a interface TokenCredential. Se não for especificado, AnonymousCredential será usado.
- options
- StoragePipelineOptions
Optional. Opções para configurar o pipeline HTTP.
Detalhes da propriedade
fileSystemName
Nome do sistema de arquivos atual.
string fileSystemName
Valor da propriedade
string
name
Nome do caminho atual (diretório ou arquivo).
string name
Valor da propriedade
string
Detalhes das propriedades herdadas
accountName
accountName: string
Valor da propriedade
string
herdado de StorageClient.accountName
credential
Como AnonymousCredential, StorageSharedKeyCredential ou qualquer credencial do pacote @azure/identity para autenticar solicitações para o serviço. Você também pode fornecer um objeto que implementa a interface TokenCredential. Se não for especificado, AnonymousCredential será usado.
credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential
Valor da propriedade
herdado de StorageClient.credential
url
Valor da cadeia de caracteres de URL codificada.
url: string
Valor da propriedade
string
herdado de StorageClient.url
Detalhes do método
create(PathResourceType, PathCreateOptions)
Crie um diretório ou caminho.
Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create
function create(resourceType: PathResourceType, options?: PathCreateOptions): Promise<PathCreateResponse>
Parâmetros
- resourceType
- PathResourceTypeModel
Tipo de recurso, "diretório" ou "arquivo".
- options
- PathCreateOptions
Optional. Opções ao criar caminho.
Retornos
Promise<PathCreateResponse>
createIfNotExists(PathResourceType, PathCreateIfNotExistsOptions)
Crie um diretório ou arquivo. Se o recurso já existir, ele não será alterado.
Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create
function createIfNotExists(resourceType: PathResourceType, options?: PathCreateIfNotExistsOptions): Promise<PathCreateIfNotExistsResponse>
Parâmetros
- resourceType
- PathResourceTypeModel
Tipo de recurso, "diretório" ou "arquivo".
- options
- PathCreateIfNotExistsOptions
Retornos
Promise<PathCreateIfNotExistsResponse>
delete(boolean, PathDeleteOptions)
Excluir o caminho atual (diretório ou arquivo).
Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/delete
function delete(recursive?: boolean, options?: PathDeleteOptions): Promise<PathDeleteResponse>
Parâmetros
- recursive
-
boolean
Obrigatório e válido somente quando o recurso é um diretório. Se "true", todos os caminhos abaixo do diretório serão excluídos.
- options
- PathDeleteOptions
Optional. Opções ao excluir o caminho.
Retornos
Promise<PathDeleteResponse>
deleteIfExists(boolean, PathDeleteOptions)
Exclua o caminho atual (diretório ou arquivo) se ele existir.
Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/delete
function deleteIfExists(recursive?: boolean, options?: PathDeleteOptions): Promise<PathDeleteIfExistsResponse>
Parâmetros
- recursive
-
boolean
Obrigatório e válido somente quando o recurso é um diretório. Se "true", todos os caminhos abaixo do diretório serão excluídos.
- options
- PathDeleteOptions
Retornos
Promise<PathDeleteIfExistsResponse>
exists(PathExistsOptions)
Retornará true se o arquivo Data Lake representado por esse cliente existir; false caso contrário.
OBSERVAÇÃO: use essa função com cuidado, pois um arquivo existente pode ser excluído por outros clientes ou aplicativos. Vice-versa, novos arquivos podem ser adicionados por outros clientes ou aplicativos após a conclusão dessa função.
function exists(options?: PathExistsOptions): Promise<boolean>
Parâmetros
- options
- PathExistsOptions
opções para a operação Exists.
Retornos
Promise<boolean>
getAccessControl(PathGetAccessControlOptions)
Retorna os dados de controle de acesso para um caminho (diretório do arquivo).
Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/getproperties
function getAccessControl(options?: PathGetAccessControlOptions): Promise<PathGetAccessControlResponse>
Parâmetros
- options
- PathGetAccessControlOptions
Optional. Opções ao obter o controle de acesso ao arquivo.
Retornos
Promise<PathGetAccessControlResponse>
getDataLakeLeaseClient(string)
Obtenha um DataLakeLeaseClient que gerencia as concessões no caminho (diretório ou arquivo).
function getDataLakeLeaseClient(proposeLeaseId?: string): DataLakeLeaseClient
Parâmetros
- proposeLeaseId
-
string
Optional. ID de concessão proposta inicial.
Retornos
getProperties(PathGetPropertiesOptions)
Retorna todos os metadados definidos pelo usuário, as propriedades HTTP padrão e as propriedades do sistema para o caminho (diretório ou arquivo).
AVISO: O objeto metadata retornado na resposta terá suas chaves em letras minúsculas, mesmo que originalmente contivessem caracteres maiúsculos. Isso difere das chaves de metadados retornadas pelos métodos de DataLakeFileSystemClient que listam caminhos usando a opção includeMetadata, que manterá sua caixa original.
Consulte https://learn.microsoft.com/rest/api/storageservices/get-blob-properties
function getProperties(options?: PathGetPropertiesOptions): Promise<PathGetPropertiesResponse>
Parâmetros
- options
- PathGetPropertiesOptions
Optional. Opções ao obter propriedades de caminho.
Retornos
Promise<PathGetPropertiesResponse>
move(string, PathMoveOptions)
Mover diretório ou arquivo no mesmo sistema de arquivos.
Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create
function move(destinationPath: string, options?: PathMoveOptions): Promise<PathMoveResponse>
Parâmetros
- destinationPath
-
string
Caminho do diretório de destino como "diretório" ou caminho de arquivo "diretório/arquivo". Se o destinationPath for autenticado com SAS, adicione a SAS ao caminho de destino como "diretório/arquivo?sasToken".
- options
- PathMoveOptions
Optional. Opções ao mover o diretório ou arquivo.
Retornos
Promise<PathMoveResponse>
move(string, string, PathMoveOptions)
Mova o diretório ou o arquivo para outro sistema de arquivos.
Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create
function move(destinationFileSystem: string, destinationPath: string, options?: PathMoveOptions): Promise<PathMoveResponse>
Parâmetros
- destinationFileSystem
-
string
Sistema de arquivos de destino como "sistema de arquivos".
- destinationPath
-
string
Caminho do diretório de destino como "diretório" ou caminho de arquivo "diretório/arquivo" Se o destinationPath for autenticado com SAS, adicione a SAS ao caminho de destino, como "diretório/arquivo?sasToken".
- options
- PathMoveOptions
Optional. Opções ao mover o diretório ou arquivo.
Retornos
Promise<PathMoveResponse>
removeAccessControlRecursive(RemovePathAccessControlItem[], PathChangeAccessControlRecursiveOptions)
Remove o Controle de Acesso em um caminho e sub-caminhos.
Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update
function removeAccessControlRecursive(acl: RemovePathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>
Parâmetros
A lista de controle de acesso POSIX para o arquivo ou diretório.
Optional. Opções
Retornos
setAccessControl(PathAccessControlItem[], PathSetAccessControlOptions)
Defina os dados de controle de acesso para um caminho (diretório do arquivo).
Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update
function setAccessControl(acl: PathAccessControlItem[], options?: PathSetAccessControlOptions): Promise<PathSetAccessControlResponse>
Parâmetros
- acl
A lista de controle de acesso POSIX para o arquivo ou diretório.
- options
- PathSetAccessControlOptions
Optional. Opções ao definir o controle de acesso do caminho.
Retornos
Promise<PathSetAccessControlResponse>
setAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)
Define o Controle de Acesso em um caminho e sub-caminhos.
Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update
function setAccessControlRecursive(acl: PathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>
Parâmetros
- acl
A lista de controle de acesso POSIX para o arquivo ou diretório.
Optional. Opções
Retornos
setHttpHeaders(PathHttpHeaders, PathSetHttpHeadersOptions)
Define as propriedades do sistema no caminho (diretório ou arquivo).
Se nenhum valor for fornecido ou nenhum valor fornecido para os cabeçalhos HTTP de blob especificados, esses cabeçalhos HTTP de blob sem um valor serão limpos.
Consulte https://learn.microsoft.com/rest/api/storageservices/set-blob-properties
function setHttpHeaders(httpHeaders: PathHttpHeaders, options?: PathSetHttpHeadersOptions): Promise<PathSetHttpHeadersResponse>
Parâmetros
- httpHeaders
- PathHttpHeaders
- options
- PathSetHttpHeadersOptions
Retornos
Promise<PathSetHttpHeadersResponse>
setMetadata(Metadata, PathSetMetadataOptions)
Define metadados definidos pelo usuário para o caminho especificado (diretório do arquivo) como um ou mais pares nome-valor.
Se nenhuma opção for fornecida ou nenhum metadados definido no parâmetro, os metadados do caminho serão removidos.
Consulte https://learn.microsoft.com/rest/api/storageservices/set-blob-metadata
function setMetadata(metadata?: Metadata, options?: PathSetMetadataOptions): Promise<PathSetMetadataResponse>
Parâmetros
- metadata
- Metadata
Optional. Substitua os metadados existentes por esse valor. Se nenhum valor fornecido, os metadados existentes serão removidos.
- options
- PathSetMetadataOptions
Optional. Opções ao definir metadados de caminho.
Retornos
Promise<PathSetMetadataResponse>
setPermissions(PathPermissions, PathSetPermissionsOptions)
Define as permissões de arquivo em um caminho.
Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update
function setPermissions(permissions: PathPermissions, options?: PathSetPermissionsOptions): Promise<PathSetPermissionsResponse>
Parâmetros
- permissions
- PathPermissions
As permissões de acesso POSIX para o proprietário do arquivo, o grupo proprietário do arquivo e outros.
- options
- PathSetPermissionsOptions
Optional. Opções ao definir permissões de caminho.
Retornos
Promise<PathSetPermissionsResponse>
toDirectoryClient()
Converta DataLakePathClient atual em DataLakeDirectoryClient se o caminho atual for um diretório.
function toDirectoryClient(): DataLakeDirectoryClient
Retornos
toFileClient()
Converta DataLakePathClient atual em DataLakeFileClient se o caminho atual for um arquivo.
function toFileClient(): DataLakeFileClient
Retornos
updateAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)
Modifica o Controle de Acesso em um caminho e sub-caminhos.
Consulte https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/update
function updateAccessControlRecursive(acl: PathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>
Parâmetros
- acl
A lista de controle de acesso POSIX para o arquivo ou diretório.
Optional. Opções