使用 DataUploader 加载数据

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

备注：

Always make sure that the data is in the required format for the app template used for the process app. Refer to App Templates.

参数

下面概述了数据上传器的参数。

参数	格式	描述	必填是/否	示例
`-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.3/DataUploader/process-mining-data-uploader.exe

使用 DataUploader 加载数据

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

下载 DataUploader。
创建一个文件夹，并使用此文件夹中的数据上传器复制要上传的输入文件。
打开 Windows Powershell。
导航到下载数据上传器的位置。
运行以下命令之一：

重要提示：

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

process-mining-data-uploader.exe "<csv dir>" "<sas url>" "<end-of-upload api>"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 -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 --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"./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"

故障排除

Maximum file size

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

Number of retries

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

警告：

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

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

请执行以下步骤：

创建名为NODE_EXTRA_CA_CERTS的环境变量。
将新环境变量的值设置为 CA 证书的文件路径。

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

Calling End of upload API

What if my files are uploaded, but end of upload endpoint is not called?

Occasionally, it can happen that End of upload API is not called successfully, even after all files are uploaded. If you do not see following log after files are uploaded from data uploader, it means that End of upload API was not called successfully:

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

In this case, you can copy and run the following code in a PowerShell session to call the End of upload 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$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之类的错误。

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

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

转到 Process Mining 门户，然后从“流程应用程序”选项卡中打开流程应用程序。
导航到网页浏览器中的地址栏，然后选择地址栏中左侧的“查看站点信息” 图标。
选择“安全连接”，然后选择“证书有效”以显示证书。
转到“详细信息”选项卡，然后展开“证书层次结构”。
选择cloud.uipath.com条目，然后选择“导出…” 。
选择一个位置以在计算机上保存证书文件，并确保将其保存类型为Base64 编码的 ASCII、证书链 (*.pem;*crt) 。

cloud.uipath.crt文件将出现在所选位置。
创建环境变量NODE_EXTRA_CA_CERTS ，并将此变量的值设置为在步骤 6 中所选证书的完整文件路径（包括文件夹路径、文件名和文件扩展名）
1. 打开“Windows 系统属性”。
2. 转到“高级”选项卡。
3. 选择“环境变量” 。
4. 选择“新建”以添加新的系统变量。
Initiate a new PowerShell session to ensure that the environment variable is recognized by the DataUploader.