AdlsClient.BulkUpload Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
BulkUpload(String, String, Int32, IfExists, IProgress<TransferStatus>, Boolean, Boolean, Boolean, CancellationToken) |
Carregue o diretório ou o arquivo do local para o remoto. Transfere o conteúdo no diretório de origem no diretório de destino. Transfere o arquivo de origem e o salva como o caminho de destino.
Esse método não gera nenhuma exceção para a falha de transferência de qualquer entrada. Consulte o valor TransferStatus retornado para obter o status/exceção da transferência de cada entrada.
É altamente recomendável definir ServicePointManager.DefaultConnectionLimit como o número de threads que o aplicativo deseja que o sdk use antes de criar qualquer instância de AdlsClient.
Por padrão, ServicePointManager.DefaultConnectionLimit é definido como 2.
Por padrão, os arquivos são carregados em novos limites de linha. No entanto, se os arquivos não tiverem uma nova linha dentro de partes de 4 MB, a transferência falhará. Nesse caso, é necessário passar true para |
BulkUpload(String, String, Int32, IfExists, Boolean, IProgress<TransferStatus>, Boolean, Boolean, Boolean, CancellationToken) |
Carregue o diretório ou o arquivo do local para o remoto. Transfere o conteúdo no diretório de origem no diretório de destino. Transfere o arquivo de origem e o salva como o caminho de destino.
Esse método não gera nenhuma exceção para a falha de transferência de qualquer entrada. Consulte o valor TransferStatus retornado para obter o status/exceção da transferência de cada entrada.
Por padrão, registra o progresso da transferência no caminho temporário do sistema, para que o usuário possa se recuperar usando |
BulkUpload(String, String, Int32, IfExists, IProgress<TransferStatus>, Boolean, Boolean, Boolean, CancellationToken)
Carregue o diretório ou o arquivo do local para o remoto. Transfere o conteúdo no diretório de origem no diretório de destino. Transfere o arquivo de origem e o salva como o caminho de destino.
Esse método não gera nenhuma exceção para a falha de transferência de qualquer entrada. Consulte o valor TransferStatus retornado para obter o status/exceção da transferência de cada entrada.
É altamente recomendável definir ServicePointManager.DefaultConnectionLimit como o número de threads que o aplicativo deseja que o sdk use antes de criar qualquer instância de AdlsClient.
Por padrão, ServicePointManager.DefaultConnectionLimit é definido como 2.
Por padrão, os arquivos são carregados em novos limites de linha. No entanto, se os arquivos não tiverem uma nova linha dentro de partes de 4 MB, a transferência falhará. Nesse caso, é necessário passar true para isBinary
para evitar uploads em limites de nova linha.
public virtual Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus BulkUpload (string srcPath, string destPath, int numThreads = -1, Microsoft.Azure.DataLake.Store.IfExists shouldOverwrite = Microsoft.Azure.DataLake.Store.IfExists.Overwrite, IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> progressTracker = default, bool notRecurse = false, bool resume = false, bool isBinary = false, System.Threading.CancellationToken cancelToken = default);
abstract member BulkUpload : string * string * int * Microsoft.Azure.DataLake.Store.IfExists * IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> * bool * bool * bool * System.Threading.CancellationToken -> Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus
override this.BulkUpload : string * string * int * Microsoft.Azure.DataLake.Store.IfExists * IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> * bool * bool * bool * System.Threading.CancellationToken -> Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus
Public Overridable Function BulkUpload (srcPath As String, destPath As String, Optional numThreads As Integer = -1, Optional shouldOverwrite As IfExists = Microsoft.Azure.DataLake.Store.IfExists.Overwrite, Optional progressTracker As IProgress(Of TransferStatus) = Nothing, Optional notRecurse As Boolean = false, Optional resume As Boolean = false, Optional isBinary As Boolean = false, Optional cancelToken As CancellationToken = Nothing) As TransferStatus
Parâmetros
- srcPath
- String
Caminho de origem local
- destPath
- String
Caminho de destino remoto – deve ser sempre um diretório.
- numThreads
- Int32
Número de threads – se não forem passados, o número padrão de threads (8 vezes o número de núcleos físicos)
- shouldOverwrite
- IfExists
Se deseja substituir ou ignorar se o destino existe
- progressTracker
- IProgress<TransferStatus>
Progresstracker para acompanhar o progresso da transferência de arquivos
- notRecurse
- Boolean
Se true, então faz uma enumeração até que o nível um faça a enumeração recursiva
- resume
- Boolean
Se for true, queremos retomar da última transferência
- isBinary
- Boolean
Se false, então grava arquivos no data lake em limites de nova linha, no entanto, se o arquivo não tiver uma nova linha dentro de partes de 4 MB, ele gerará exceção. Se for true, o upload em novos limites de linha não será resumido, mas o carregamento será mais rápido. Por padrão, false, se o arquivo não tiver novas linhas em partes de 4 MB true, deverá ser apssed
- cancelToken
- CancellationToken
Token de cancelamento
Retornos
Status da Transferência encapsulando os detalhes do upload
Aplica-se a
BulkUpload(String, String, Int32, IfExists, Boolean, IProgress<TransferStatus>, Boolean, Boolean, Boolean, CancellationToken)
Carregue o diretório ou o arquivo do local para o remoto. Transfere o conteúdo no diretório de origem no diretório de destino. Transfere o arquivo de origem e o salva como o caminho de destino.
Esse método não gera nenhuma exceção para a falha de transferência de qualquer entrada. Consulte o valor TransferStatus retornado para obter o status/exceção da transferência de cada entrada.
Por padrão, registra o progresso da transferência no caminho temporário do sistema, para que o usuário possa se recuperar usando resume
se o upload tiver falhado.
Esse log de progresso pode ser desabilitado usando disableTransferLogging
.
É altamente recomendável definir ServicePointManager.DefaultConnectionLimit como o número de threads que o aplicativo deseja que o sdk use antes de criar qualquer instância de AdlsClient.
Por padrão, ServicePointManager.DefaultConnectionLimit é definido como 2.
Por padrão, os arquivos são carregados em novos limites de linha. No entanto, se os arquivos não tiverem uma nova linha dentro de partes de 4 MB, a transferência falhará. Nesse caso, é necessário passar true para isBinary
para evitar uploads em limites de nova linha.
public virtual Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus BulkUpload (string srcPath, string destPath, int numThreads, Microsoft.Azure.DataLake.Store.IfExists shouldOverwrite, bool disableTransferLogging, IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> progressTracker, bool notRecurse, bool resume, bool isBinary, System.Threading.CancellationToken cancelToken);
abstract member BulkUpload : string * string * int * Microsoft.Azure.DataLake.Store.IfExists * bool * IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> * bool * bool * bool * System.Threading.CancellationToken -> Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus
override this.BulkUpload : string * string * int * Microsoft.Azure.DataLake.Store.IfExists * bool * IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> * bool * bool * bool * System.Threading.CancellationToken -> Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus
Public Overridable Function BulkUpload (srcPath As String, destPath As String, numThreads As Integer, shouldOverwrite As IfExists, disableTransferLogging As Boolean, progressTracker As IProgress(Of TransferStatus), notRecurse As Boolean, resume As Boolean, isBinary As Boolean, cancelToken As CancellationToken) As TransferStatus
Parâmetros
- srcPath
- String
Caminho de origem local
- destPath
- String
Caminho de destino remoto – deve ser sempre um diretório.
- numThreads
- Int32
Número de threads – Padrão -1, se não passado, o número padrão de threads (8 vezes o número de núcleos físicos)
- shouldOverwrite
- IfExists
Se deseja substituir ou ignorar se o destino existir, Padrão IfExists.Overwrite
- disableTransferLogging
- Boolean
Se for true, o registro em log do progresso da transferência será desabilitado. Isso e resume
não podem ser verdadeiros ao mesmo tempo. Falso padrão
- progressTracker
- IProgress<TransferStatus>
Progresstracker para acompanhar o progresso da transferência de arquivo, Nulo padrão
- notRecurse
- Boolean
Se true fizer uma enumeração até que o nível um faça a enumeração recursiva, Padrão false
- resume
- Boolean
Se for true, queremos retomar da última transferência, Padrão falso
- isBinary
- Boolean
Se false, então grava arquivos no data lake em limites de nova linha, no entanto, se o arquivo não tiver uma nova linha dentro de partes de 4 MB, ele gerará exceção. Se for true, o upload em novos limites de linha não será resumido, mas o carregamento será mais rápido. Por padrão, false, se o arquivo não tiver novas linhas em partes de 4 MB true, deverá ser apssed
- cancelToken
- CancellationToken
Token de cancelamento
Retornos
Status da Transferência encapsulando os detalhes do upload
Aplica-se a
Azure SDK for .NET