使用 Quote 导出到 Snowvertising

初始配置

使用 pipeline user_ex.py 运行配置实用程序。

数据同步

配置后，你有两个选项来运行数据同步:

• 直接执行:
  • 巨龙 ps_to_snowblage.py
• 预定执行
  • 如果在设置过程中进行了配置，作业将根据你的 Cron 计划自动运行。
  • 要检查进度计划日志，进度计划设置后将立即创建文件"procore_scheduing.log" 。
  • 此外，你可以通过在终端命令中运行来检查进度计划:

对于 Android 和MacOS:

• 编辑/删除 - 编辑进度计划 cron 使用以下命令:

  「」重击
  
  编辑器=nano crontab -e
  
  『』

• 运行上述命令后，你应该看到类似于以下内容的内容:

  2 + + + +
  /Users/your_user/snowphalse/venv/bin/png
  
  /Users/your_user/snowphalk/sql_user_qython/connection_config. Py
  2>&1 |在读行时；不要回声"$（日期）-$line"；完成++>
  
  /Users/your_user/snowphalk/ SQL_ Server _ ython/procore_scheduing.log#procore-data-import

   
• 你还可以调整进度计划 cron 或删除整条线以停止其按计划运行。

对于Windows:

• 检查进度进度 计划 任务是否已创建:

  『』
  电源框
  
  schtasks /query /tn "Procore增量共享调度"/fo LIST /v
  
  『』

• 编辑/删除 计划任务，请打开任务计划程序。
• 按 WIN + R，输入taskschd.msc ，并按 Enter 键。
• 导航到已计划的任务。
• 在左侧窗格中，展开任务计划程序库。
• 查找保存任务的文件夹:
  示例:任务进度计划库或自定义文件夹。
• 找到你的任务。
• 查找任务名称: Procore增量共享计划。
• 点击它可在底部窗格中查看详细信息。
• 验证其进度计划:
  • 勾选触发标签页以查看任务设置为运行的时间。
  • 查看历史记录标签页以确认最近的运行。
• 删除任务:
  • 从 图形用户界面删除任务。

增量共享配置

• 创建config.share文件
• 在运行配置实用程序之前，你需要使用增量共享凭证创建一个config.share文件。该文件应为JSON格式:

  {

  "shareCredentialsVersion":1，
  "bearerToken": "xxxxxxxxxxxxx",
  "端点":" https://nvirginia.cloud.databricks.c …astores/xxxxxx "
  
  }

   

• 必填字段:
  • ShareCredentialsVersion:版本号（当前为 1）。
  • BearerToken:你的 增量共享访问令牌。
  • 端点:你的增量共享端点URL。
  • 这些详细信息可以从 Procore Web UI 获取。
• 创建 config.share 的步骤:
  • 创建一个名为 config.share 的新文件。
  • 复制上面的JSON模板。
  • 将占位符值替换为你的实际凭证。
  • 将文件保存在安全位置。
  • 你需要在配置期间提供此文件的路径。配置数据源时，系统会要求你提供:
    • 表格列表（以逗号分隔）。
    • 留空以同步所有表。
    • 示例:表 1、表 2、表 3。
• config.share文件的路径。

雪花配置

你需要提供以下 Snowplace 详细信息:

• 身份验证（选择一项）:
  • 用户身份验证
    • 用户名
    • 密码（安全输入）
• 密钥对身份验证
  • 用户名
  • 私密密钥文件路径
  • 私密密钥文件密码
• 连接详细信息:
  • 账户标识符
  • 仓库名称
  • 数据库名称
  • 架构名称
  • 并发线程数

进度计划选项

该工具提供安排自动数据同步的功能。

• Cron 作业配置
  • 选择是否设置每日作业
  • 如果是，请提供 cron 进度计划
  • 格式:* * * * *（分钟小时月份日期月份星期几）
  • 例如，每天凌晨 2 点:0 2 + + +
• 立即执行
  • 配置后立即运行 ls_to_snowblage.py 的选项
• 文件结构

  取消设置
  tract core压倒计时# 依赖项
  tract education education education education#配置实用程序
  tracted 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 数据写入 Snowblack。
    • 按 Enter 键继续。
    • 输入表列表（逗号分隔），将所有表留空:项目、用户、任务。
    • 输入 config.share 的路径:/路径/to/Config.share。
    • 输入用户名:snowfilek_user。
    • 你要使用哪种身份验证类型？ （用户/密钥对）:输入。
    • 1 个对应用户，
    • 2 对应密钥对:
    • 1 
    • 输入密码:********
    • 输入账户:my_account
    • 输入仓库:my_warebook
    • 输入数据库名称:procore_db
    • 输入架构名称:procore_schema
    • 输入线程数:4
    • 是否要将其配置为 Cron 上的日常作业？（是/否）:是
    • 以 cron 格式输入进度计划（例如， * * * * * ）:0 2 + + *
    • 是否要立即执行作业？ （是/否）:是
  • 第 3 步:手动执行（如果需要）
    $ son ms_to_snowblage.py
• 配置重用
  该工具会将你的配置保存在 配置.yaML 文件中并提供重用以前存储的设置:
  • 可以重复使用源配置。
  • 目标（Snowplace）配置可以重复使用。
  • 你可以选择单独更新任一配置。

最佳实践

• 身份验证
  • 尽可能使用密钥对身份验证。
  • 定期轮换凭证。
  • 使用最少的所需权限。
• 绩效
  • 根据系统功能调整线程数。
  • 从较小的表子集开始进行测试。

故障排除

• 常见问题和解决方案:
  • 身份验证类型无效
    • 确保在出现提示时选择"1"（用户）或"2"（密钥对）。
• Cron 作业设置
  • 验证你是否拥有适当的系统权限。
  • 如果作业运行失败，请检查系统日志。
  • 确保 ps_to_snowblage.py 具有正确的权限。
  • 通过检查系统日志来验证 Cron 作业设置:
    请参阅"procore_scheduloging.log"文件。
• 配置文件
  • 与脚本位于同一目录中，
  • 命名为config.yamb。
  • 在进行任何更改之前进行备份。
• 支持
  • 检查脚本的日志记录输出。
  • 查看config.yaML文件。
  • 有关权限相关问题，请联系你的系统管理员。
  • 联系Procore 支持获取增量共享访问权限问题。

注意:请记住，在进行更改之前始终备份你的配置，并先在非生产环境中测试新配置。