使用 DataUploader 加载数据

使用 DataUploader ，您可以将每个最大 5TB 的数据文件直接上传到 Process Mining 流程应用程序中。 使用 DataUploader 加载数据比使用 Process Mining 中的“ 上传数据” 选项加载数据更稳定，对于较小的数据文件也是如此。如果使用“数据上传器” 上传 失败（例如，由于连接不稳定），“数据上传器” 最多 将重试上传 4 次。

备注：

始终确保用于流程应用程序的应用程序模板，其中的数据采用适当的格式。 请参阅应用程序模板。

参数

下表描述了DataUploader的参数。

参数	格式	描述	必填 是/否	示例
-c --csv-dir	<csv dir value>	包含要上传的 CSV 文件的目录。 备注： 这也可以是相对路径。	Y	C:\P2P 数据
-s --sas-url	<sas url value>	需要上传文件的 Azure Blob 存储容器的共享访问签名 (SAS) URL。 请查看检索 Azure Blob 存储的凭据	Y
-e --end-of-upload-api	<value>	成功上传文件后将调用的上传结束 API 的 URL。 请查看检索 Azure Blob 存储的凭据	Y
-d --delimiter	<delimiter value>	输入文件中使用的分隔符的 ASII 代码。 备注： 这必须是介于0和127之间的 ASCII 值。 默认值为9 (制表符)。	N	44 （= 逗号） 9 (= Tab)
-p --proxy	<proxy value>	代理 URL	N
-u --proxy-username	<proxy username>	如果需要身份验证才能连接到代理服务器，则用户名。	N
-P --proxy-password	<proxy password>	如果需要身份验证才能连接到代理服务器，则需要输入密码。	N
-r --recursive		查找给定文件夹中的所有文件，包括子文件夹。 注意： 如果不同的文件夹中存在名称重复的文件，则行为可能是不可预测的。 备注： 默认情况下，仅上传给定文件夹中的文件，而忽略子文件夹。
-f --config-file	<config file value>	允许您使用配置文件代替内联参数。 注意： 内联参数将覆盖配置文件中的值。
-h		用于显示数据上传器命令的帮助。

正在下载数据上传器

使用以下链接下载 DataUploader： https://download.uipath.com/ProcessMining/versions/2.0.5/DataUploader/process-mining-data-uploader.exe

使用 DataUploader 加载数据

请按照以下步骤使用数据 上传器加载数据。

1. 下载 DataUploader。

2. 创建一个文件夹，并使用此文件 夹 中的数据上传器复制要上传的输入文件。

3. 打开 Windows Powershell。

4. 导航到下载数据上传器的 位置。

5. 运行以下命令之一：

重要提示：

将每个参数值用引号括起来。

 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"

每次上传文件时，系统都会显示一个进度条。

命令字符串示例

 ./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"

故障排除

最大文件大小

（每个文件）的最大文件大小为 5TB。

重试次数

如果上传失败（例如由于连接 不稳定 ），“数据上传器”将重试上传（最多 4 次）。 如果 5 次后数据上传均未成功，则系统会创建报告。

警告：

在某些网络配置下，由于存在自签名证书，数据上传器无法访问上传结束 API，并且您将收到诸如UNABLE_TO_GET_ISSUER_CERT_LOCALLY之类的错误。

可通过将数据上传器指向您组织的证书颁发机构 (CA) 证书来解决此问题。

请执行以下步骤：

1. 创建名为NODE_EXTRA_CA_CERTS的环境变量。

2. 将新环境变量的值设置为 CA 证书的文件路径。

如果某些文件上传失败，您可以使用相同的命令并使用相同的文件重新启动“数据上传器”。

调用结束上传 API

如果我的文件已上传，但未调用上传结束端点怎么办？

有时，即使是在上传所有文件之后，也可能会发生未成功调用上传结束 API 的情况。 如果从数据上传器上传文件后您看不到以下日志，则表示未成功调用结束上传 API：

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

在这种情况下，您可以在 PowerShell 会话中复制并运行以下代码，以调用上传结束 API。

 $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

证书

警告：

在某些网络配置下，由于存在自签名证书，数据上传器无法访问上传结束 API，并且您将收到诸如UNABLE_TO_GET_ISSUER_CERT_LOCALLY之类的错误。

您可以通过为数据上传器提供有效的证书链来解决此问题。

请按照以下步骤为数据上传器提供有效的证书链。

1. 转到 Process Mining 门户，然后从“流程应用程序”选项卡中打开流程应用程序。

2. 导航到网页浏览器中的地址栏，然后选择地址栏中左侧的“查看站点信息” 图标。

   
   

   

   
   

3. 选择“安全连接”，然后选择“证书有效”以显示证书。

   
   

   

   
   

4. 转到“详细信息”选项卡，然后展开“证书层次结构”。

5. 选择cloud.uipath.com条目，然后选择“导出…” 。

   
   

   

   
   

6. 选择一个位置以在计算机上保存证书文件，并确保将其保存类型为Base64 编码的 ASCII、证书链 (*.pem;*crt) 。

   cloud.uipath.crt文件将出现在所选位置。

7. 创建环境变量NODE_EXTRA_CA_CERTS ，并将此变量的值设置为在步骤 6 中所选证书的完整文件路径（包括文件夹路径、文件名和文件扩展名）

   1. 打开“Windows 系统属性”。

   2. 转到“高级”选项卡。

   3. 选择“环境变量” 。

   4. 选择“新建”以添加新的系统变量。

      
      

      

      
      

8. 启动一个新的 PowerShell 会话，以确保 数据上传器 可以识别该环境变量。