AzureFileDatastore Classe
Representa um arquivo de dados que guarda informações de ligação ao armazenamento de Ficheiros do Azure.
Não deve trabalhar diretamente com esta turma. Para criar um arquivo de dados deste tipo, utilize o register_azure_file_share método datastore.
Nota: ao utilizar um arquivo de dados para aceder aos dados, tem de ter permissão para aceder a esses dados, o que depende das credenciais registadas no arquivo de dados.
Inicializar um novo Arquivo de Dados da Partilha de Ficheiros do Azure.
- Herança
-
AzureFileDatastore
Construtor
AzureFileDatastore(workspace, name, container_name, account_name, sas_token=None, account_key=None, protocol=None, endpoint='core.windows.net', request_session=None)
Parâmetros
- sas_token
- str, <xref:optional>
O token de SAS para aceder a este contentor. A predefinição é Nenhum.
- account_key
- str, <xref:optional>
A chave da conta de armazenamento. A predefinição é Nenhum.
- protocol
- str, <xref:optional>
O protocolo a utilizar para ligar à conta de armazenamento. Se Não, a predefinição é https.
- endpoint
- str, <xref:optional>
O ponto final do contentor de blobs. Se Não, a predefinição é core.windows.net.
- request_session
- <xref:requests.sessions.Session>, <xref:optional>
O objeto de sessão a utilizar para pedidos http. A predefinição é Nenhum.
- sas_token
- str, <xref:optional>
O token de SAS para aceder a este contentor. A predefinição é Nenhum.
- account_key
- str, <xref:optional>
A chave da conta de armazenamento. A predefinição é Nenhum.
- protocol
- str, <xref:optional>
O protocolo a utilizar para ligar à conta de armazenamento. Se Não, a predefinição é https.
- endpoint
- str, <xref:optional>
O ponto final do contentor de blobs. Se Não, a predefinição é core.windows.net.
- request_session
- <xref:requests.sessions.Session>, <xref:optional>
O objeto de sessão a utilizar para pedidos http. A predefinição é Nenhum.
Métodos
download |
Transfira os dados da partilha de ficheiros para o sistema de ficheiros local. |
upload |
Carregue os dados do sistema de ficheiros local para o ficheiro para o qual este arquivo de dados aponta. Nota: para que este método funcione, o objeto do arquivo de dados tem de ter a chave de conta ou a propriedade do token de SAS preenchida. Se o objeto arquivo de dados não contiver qualquer forma de credencial, este método falhará.
Além disso, este método foi preterido, pode ser removido no futuro. Sugerimos que utilize o método para carregar os |
upload_files |
Carregue os dados do sistema de ficheiros local para o ficheiro para o qual este arquivo de dados aponta. Nota: este método foi preterido e deixará de ser suportado. Em vez disso, recomendamos que utilize |
download
Transfira os dados da partilha de ficheiros para o sistema de ficheiros local.
download(target_path, prefix=None, overwrite=False, show_progress=True)
Parâmetros
- prefix
- str, <xref:optional>
O caminho para a pasta na partilha de ficheiros a transferir. Se estiver definido como Nenhum, o Azure Machine Learning irá transferir tudo na partilha de ficheiros.
- overwrite
- bool, <xref:optional>
Indica se deve substituir o ficheiro existente.
- show_progress
- bool, <xref:optional>
Indica se pretende mostrar o progresso da transferência na consola do .
Devoluções
O número de ficheiros transferidos com êxito.
Tipo de retorno
upload
Carregue os dados do sistema de ficheiros local para o ficheiro para o qual este arquivo de dados aponta.
Nota: para que este método funcione, o objeto do arquivo de dados tem de ter a chave de conta ou a propriedade do token de SAS preenchida. Se o objeto arquivo de dados não contiver qualquer forma de credencial, este método falhará.
Além disso, este método foi preterido, pode ser removido no futuro. Sugerimos que utilize o método para carregar os Dataset.File.upload_directory
seus ficheiros a partir do diretório local e criar FileDataset numa única chamada de método.
upload(src_dir, target_path=None, overwrite=False, show_progress=True)
Parâmetros
- target_path
- str
A localização na partilha de ficheiros para onde carregar. Se Nenhum, carregue para a raiz.
- show_progress
- bool, <xref:optional>
Indica se pretende mostrar o progresso do carregamento na consola do .
Devoluções
A instância DataReference para o caminho de destino carregado.
Tipo de retorno
upload_files
Carregue os dados do sistema de ficheiros local para o ficheiro para o qual este arquivo de dados aponta.
Nota: este método foi preterido e deixará de ser suportado. Em vez disso, recomendamos que utilize FileDatasetFactory.upload_directory
.
upload_files(files, relative_root=None, target_path=None, overwrite=False, show_progress=True)
Parâmetros
- relative_root
- str, <xref:optional>
O caminho base utilizado para determinar o caminho dos ficheiros na partilha de ficheiros. Por exemplo, se carregar /path/to/file.txt e definir o caminho base como /path, quando file.txt for carregado para a partilha de ficheiros, terá o caminho de /para/file.txt. Se target_path
também for especificado, será utilizado como o prefixo do caminho derivado acima. O caminho base tem de ser um caminho comum de todos os ficheiros. Caso contrário, será emitida uma exceção. A predefinição é Nenhum, que irá encontrar o caminho comum.
- target_path
- str, <xref:optional>
A localização na partilha de ficheiros para onde carregar os dados. A predefinição é Nenhuma, a raiz.
- show_progress
- bool, <xref:optional>
Indica se pretende mostrar o progresso do carregamento na consola do .
Devoluções
A instância DataReference para o caminho de destino carregado.
Tipo de retorno
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários