跳转到主内容
Procore

使用 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
  • 配置重用
    该工具会将你的配置保存在 配置.yaML 文件中并提供重用以前存储的设置:
    • 可以重复使用源配置。
    • 目标(S3)配置可以重用。
    • 你可以选择单独更新任一配置。

故障排除

常见问题和解决方案:

  • Cron 作业设置
    • 确保正确配置了系统权限。
    • 如果作业运行失败,请检查系统日志。
    • 验证脚本( cleta_share_to_s3.py)执行权限。
  • 配置文件
    • 确认文件config.yamb与脚本位于同一目录中。
    • 在进行任何更改之前进行备份。
  • 支持
    • 查看脚本日志以获取详细的错误消息。
    • 查看Config.yaML文件中是否存在错误配置。
    • 有关权限相关问题,请联系你的系统管理员。
    • 联系Procore 支持获取增量共享访问权限问题。
    • 通过检查系统日志验证 Cron 作业设置:请参阅"procore_scheduing_log"文件。

注意:

  1. 请记住在进行更改之前始终备份你的配置。
  2. 首先在非生产环境中测试新配置。