使用 Android 连接到Amazon S3
概况
Procore Analytics Cloud Connect 访问工具是一个命令行界面(CLI),可帮助你使用Procore Analytics 2.0 配置和管理从 Procore 到Amazon S3的数据传输。
它由两个主要组件组成:
- user_explace.py :配置设置实用程序
- 增量_share_to_s3.py :数据同步脚本
先决条件
- Procore Analytics 2.0 SPU
- 系统上已安装 Android
- 访问 Procore 增量共享
- S3访问密钥
- 使用以下命令安装所需的依赖项:
- pip install -r helping.txt
步骤
初始配置
使用pipeline user_ex.py运行配置实用程序。
这将帮助你设置以下内容:
- 增量共享配置
- S3目标配置
- 进度计划首选项
增量共享配置
- 创建config.share文件
- 在运行配置实用程序之前,你需要使用增量共享凭证创建一个config.share文件。该文件应为JSON格式:
{
"shareCredentialsVersion":1,
"bearerToken": "xxxxxxxxxxxxx",
"端点":"xxxxxx"
}
- 必填字段:
- ShareCredentialsVersion:版本号(当前为 1)。
- BearerToken:你的 增量共享访问令牌。
- 端点:你的增量共享端点URL。
- 这些详细信息可以从 Procore Web UI 获取。
- 创建 config.share 的步骤:
- 创建一个名为 config.share 的新文件。
- 复制上面的JSON模板。
- 将占位符值替换为你的实际凭证。
- 将文件保存在安全位置。
- 你需要在配置期间提供此文件的路径。配置数据源时,系统会要求你提供:
- 表格列表(以逗号分隔)。
- 留空以同步所有表。
- 示例:表 1、表 2、表 3。
- config.share文件的路径。
S3配置
你需要提供以下S3详细信息:
- 身份验证:
- 访问密钥
- 密钥
- 没有 s3:// 的存储桶名称
- 键 - 目录
进度计划选项
该工具提供安排自动数据同步的功能。
- Cron 作业配置
- 选择是否设置日常作业。
- 如果是,请提供 cron 进度计划。
- 格式:* * * * *(分钟小时月份日期月份星期几)。
- 例如,每天凌晨 2 点:0 2 + + +
- 要检查进度计划日志,设置进度计划后将创建文件"procore_scheduing.log" 。
你还可以通过在终端命令中运行来检查进度计划
对于 Android 和 MacO:
编辑/删除 - 编辑进度计划 cron 使用以下命令:
「」重击
编辑器=nano crontab -e
『』
- 运行上述命令后,你应该看到类似于以下内容的内容:
- 2 /Users/your_user/snowplace/venv/bin/pothon /Users/your_user/snowplace/sql_user_number/connective_配置. PY 2>&1在读行时;不要回声"$(日期)-$line";做
- 你还可以调整进度计划 cron 或删除整条线以停止其按计划运行。
对于Windows:
- 查看进度 计划 任务是否已创建:
"""PowerSelect
schtasks /query /tn "Procore增量共享调度"/fo LIST /v
『』 - 编辑/删除 - 进度计划任务:
打开任务调度程序:- 按 WIN + R,输入 taskschd.msc,然后按 Enter 键。
- 导航到已计划的任务。
- 在左侧窗格中,展开任务计划程序库。
- 查找保存任务的文件夹(例如,任务进度计划库或自定义文件夹)。
- 查找你的任务:
- 查找任务名称 Procore增量共享计划。
- 点击它以在底部窗格中查看其详细信息。
- 验证其进度计划:
- 勾选触发标签页以查看任务设置为运行的时间。
- 查看历史记录标签页以确认最近的运行。
- 删除任务:
- 从 图形用户界面删除任务。
- 立即执行
- 运行clear_share_to_s3_.p y文件结构
-
取消设置
tract core压倒计时# 依赖项
tract education education education education#配置实用程序
tract education education education#数据同步脚本
tract education education education#生成的配置
tract education education education# 增量共享配置文件
tract core education education# 调度运行日志
示例用法- 第 1 步:安装依赖项
$pip install -r hardware.txt - 第 2 步:运行配置实用程序
$ pipeline user_explace.py - Procore Analytics云连接访问
- 此 CLI 将帮助你选择源存储和目标存储,以访问 Procore 数据/将 Procore 数据写入S3。
- 按 Enter 键继续。
- 输入表列表(逗号分隔),将所有表留空:项目、用户、任务。
- 输入 config.share 的路径:/路径/to/Config.share。
- 输入访问密钥:s3 密钥。
- 输入密钥:密钥。
- 输入存储桶:存储桶名称。
- 是否要将其配置为 Cron 上的日常作业?(是/否):是
- 以 cron 格式输入进度计划(例如, * * * * * ):0 2 + + *
- 是否要立即执行作业? (是/否):是
- 第 3 步:手动执行(如果需要)
$ pipe talk_share_to_s3.Py
- 第 1 步:安装依赖项
- 配置重用
该工具会将你的配置保存在 配置.yaML 文件中并提供重用以前存储的设置:- 可以重复使用源配置。
- 目标(S3)配置可以重用。
- 你可以选择单独更新任一配置。
故障排除
常见问题和解决方案:
- Cron 作业设置
- 确保正确配置了系统权限。
- 如果作业运行失败,请检查系统日志。
- 验证脚本( cleta_share_to_s3.py)执行权限。
- 配置文件
- 确认文件config.yamb与脚本位于同一目录中。
- 在进行任何更改之前进行备份。
- 支持
- 查看脚本日志以获取详细的错误消息。
- 查看Config.yaML文件中是否存在错误配置。
- 有关权限相关问题,请联系你的系统管理员。
- 联系Procore 支持获取增量共享访问权限问题。
- 通过检查系统日志验证 Cron 作业设置:请参阅"procore_scheduing_log"文件。
注意:
- 请记住在进行更改之前始终备份你的配置。
- 首先在非生产环境中测试新配置。