Executando o DataUploader

Siga estas etapas para carregar dados usando o DataUploader.

1. Baixe o DataUploader.
2. Crie uma pasta e copie os arquivos de entrada que você deseja carregar usando DataUploader nesta pasta.
3. Abra um Powershell do Windows.
4. Navegue até o local onde você baixou o DataUploader.
5. Execute um dos seguintes comandos:
   Importante:

   Coloque cada valor de parâmetro entre aspas.

process-mining-data-uploader.exe "<csv dir>" "<sas url>" "<end-of-upload api>"

process-mining-data-uploader.exe -c "<myfolder>" -s "<my-sas-uri>" -e "<my-end-of-upload-api>"

process-mining-data-uploader.exe --config-file "path\to\config\file"

Uma barra de progresso é exibida para cada carregamento de arquivo.

Exemplo de string de comando

./process-mining-data-uploader.exe "data" "https://asdf.blob.core.windows.net/a28d10b0-6822-4xxy-a197-02zz39824ad4?sv=2020-06-12&si=sap-a58d10b0-6822-4ffc-a197-02ed649824ad4&sr=c&sig=WELk3bW8zpY5rL71lJ8pPPhlOq0odLNoQleY%2BL3nPqek%3D" "https://asdf.uipath.com/org/tenant/processmining_/api/v4.0/apps/a28d10b0-6822-4ffc-a197-02ed39824ad4/ingest/authenticated?AppSecretToken=A5B221CD00E77F02677G36H572IJKLM61N2440320O44666PQ4RS3T0U81410VW" "44"

Extração incremental

Siga estas etapas para executar o DataUploader com sincronização incremental.

1. Abra um Windows Powershell e navegue até o local em que você baixou o DataUploader.
2. Certifique-se de que todos os arquivos de entrada sigam o formato de nomenclatura exigido. Consulte Nomenclatura do arquivo para sincronização incremental.
3. Execute o DataUploader com o parâmetro --tables . O código a seguir mostra um comando de exemplo.

   process-mining-data-uploader.exe -c "<csv dir>" -s "<sas url>" -e "<end-of-upload api>" --tables '[{"prefix": "pfx01", "name": "Table01", "load-type": "incremental"}, {"prefix": "pfx02", "name": "Table02", "load-type": "full"}]'
   

   Importante:

   Coloque cada valor de parâmetro entre aspas.

Observação:

Após cada execução, o DataUploader salva o status de sincronização em um arquivo na mesma pasta que o executável.

Observação:

Os arquivos cujo prefixo não corresponde a nenhuma entrada no --tables são ignorados. Quando --tables não é fornecido, todos os arquivos na pasta são carregados.

Nomenclatura do arquivo para sincronização incremental

Todos os arquivos destinados à ingestão incremental devem seguir este formato de nomenclatura:

<table-prefix>_<any text>_<yyyymmdd>T<HHMMSS>.<extension>

Exemplo:

pfx01_filename-part-not-read-by-data-uploader_20240221T142100.csv

Parte	Description
<table-prefix>	Deve corresponder a um prefixo definido no parâmetro --tables . Não deve conter sublinhados.
<any text>	Qualquer texto descritivo. Não usado pelo DataUploader.
<yyyymmdd>T<HHMMSS>	Registro de data/hora da extração de dados da origem. T separa data e hora.
<extension>	Qualquer extensão de arquivo.

Solução de problemas

Tamanho máximo do arquivo

O tamanho máximo do arquivo (por arquivo) é 5TB.

NúmeroDeNovasTentativas

Se o upload falhar, por exemplo, devido a uma conexão instável, o DataUploader tentará carregar novamente até quatro vezes. Se o upload de dados não tiver sido bem-sucedido após 5 vezes, um relatório será criado.

AVISO:

Sob determinadas configurações de rede, o DataUploader não consegue alcançar a API de fim de upload devido a um certificado autoassinado, e você receberá um erro como UNABLE_TO_GET_ISSUER_CERT_LOCALLY. Isso pode ser resolvido apontando o DataUploader para o certificado da Autoridade de Certificação (CA) da sua organização. Siga estas etapas.

1. Crie uma variável de ambiente chamada NODE_EXTRA_CA_Certs.
2. Defina o valor da nova variável de ambiente como o caminho do arquivo do seu certificado de CA.

Caso alguns dos arquivos tenham falhado no upload, você pode reiniciar DataUploader usando o mesmo comando e com os mesmos arquivos.

Chamando a API de fim de upload

E se meus arquivos forem carregados, mas o ponto de extremidade de fim de upload não for chamado?

Ocasionalmente, pode acontecer que a API de Fim de upload não seja chamada com sucesso, mesmo depois de todos os arquivos serem carregados. Se você não vir o log a seguir após os arquivos serem carregados a partir do carregador de dados, isso significa que a API de Fim de upload não foi chamada com sucesso:

End-of-upload API reached successfully, data transformation started.

Nesse caso, você pode copiar e executar o seguinte código em uma sessão do PowerShell para chamar a API de Fim de upload.

$endOfUploadUri = "*******"
$delimiter = 9 # you can change this to the ascii of the character of your choice
$fullUri = "$endOfUploadUri&dataLoadOptionsJson=%7B%22UseSampleData%22%3Afalse%2C%22FileFormatOptions%22%3A%7B%22FieldDelimiter%22%3A%22$delimiter%22%7D%7D"
$response = Invoke-WebRequest -Uri $fullUri -Method POST
Write-Output $response.StatusCode

Certificados

AVISO:

Sob determinadas configurações de rede, o DataUploader não consegue atingir a API de fim de upload devido a um certificado autoassinado, e você receberá um erro como UNABLE_TO_GET_ISSUER_CERT_LOCALLY. Você pode corrigir isso fornecendo ao DataUploader a cadeia de certificados válida.

Siga estas etapas para fornecer ao DataUploader a cadeia de certificados válida.

1. Acesse o Portal do Process Mining e, na guia Aplicativos de processos , abra o aplicativo de processos.

2. Navegue até a barra de endereço no navegador da web e selecione o ícone Exibir informações do site à esquerda na barra de endereço.

   

3. Selecione A conexão é segura e, em seguida, selecione O certificado é válido para exibir o certificado.

   

4. Acesse a guia Detalhes e expanda a Hierarquia de certificados.

5. Selecione a entrada cloud.uipath.com e selecione Exportar....

   

6. Selecione um local para salvar o arquivo de certificado no seu computador e certifique-se de salvá-lo como ASCII codificado em Base64, cadeia de certificados (*.pem;*crt).

   O arquivo cloud.uipath.crt aparecerá no local selecionado.

7. Crie uma variável de ambiente NODE_EXTRA_CA_Certs e defina o valor dessa variável como o caminho completo do arquivo do certificado selecionado na etapa 6 (incluindo o caminho da pasta, o nome do arquivo e a extensão do arquivo)

   1. Abra as Propriedades do sistema do Windows.
   2. Go to the Advanced tab.
   3. Selecione Variáveis de ambiente.
   4. Selecione Novo para adicionar uma nova Variável do sistema.

8. Inicie uma nova sessão do PowerShell para garantir que a variável de ambiente seja reconhecida pelo DataUploader.