配置 Python 以便与 Analytics 一起使用

要配置 Python 以使用 Analytics,您必须安装兼容版本的 Python,并且将可执行文件添加至您的系统 PATH 环境变量。您还必须设置 ACLPYTHONDLLPYTHONPATH 系统环境变量。

工作原理

要运行 Python 脚本,Analytics 必须能够调用 Python 可执行文件并且找到它要按照指示运行的脚本。Analytics 使用 PATH 环境变量来查找 Python,使用 PYTHONPATH 环境变量来查找脚本。

安装 Python 版本 3.3.x 及更高版本(32 位)

  1. Python 下载页面中,将某个版本的 Python 下载到您的计算机。

    说明

    我们建议使用 Python 3.5,因为它已被测试和验证,可以正确地与 Analytics 一起工作。 从 3.3.x 以来的任何版本的 Python 也都应该能够与 Analytics 一起工作,但除 3.5 以外的版本不能保证在每个地区都能工作。

  2. 在您的计算机上,双击安装程序。
  3. 在安装程序中,选择添加 Python 版本号到 PATH
  4. 单击安装并按照屏幕上的说明操作。
  5. 在从 Analytics 运行任何 Python 脚本之前重启计算机。

设置 ACLPYTHONDLL 和 PYTHONPATH 环境变量

  1. 在您的 Windows 操作系统中,创建一个或多个文件夹以存放您的 Python 脚本。

    样例C:\python_scripts

  2. 从您的 Windows 操作系统中,打开系统属性对话框,然后单击环境变量
  3. 系统变量部分,单击新建并输入下列变量:
    变量名称变量值示例
    PYTHONPATH您创建的用来存放 Python 脚本的文件夹的完整路径。用分号分隔多个文件夹路径。C:\python_scripts;C:\dev;C:\tmp
    ACLPYTHONDLL

    您想要通过 Analytics 使用的 Python 安装文件夹中的 Python DLL 文件的完整路径和文件名。

    如果您使用的是 Python 3.3.x,则适用下列限制:

    • 欧洲语言平台的路径中不支持 Unicode 字符
    • 亚洲语言平台的路径中不支持扩展字符

    说明

    Python 向系统文件夹 (c:\windows\system32\python33.dll) 而非安装文件夹中添加 DLL。您必须将该 DLL 从系统文件夹复制到安装文件夹,并且使用它作为变量值,以便 Analytics 可以访问该 DLL。

    您可能还需要从安装文件夹中移除任何只读设置。

    如果您不设置此值,则 Analytics 会尝试使用默认的受支持版本 3.5.x DLL python35.dll

    c:\python_install\python33.dll
  4. 要保存变量,请单击确定,然后在系统属性对话框,然后单击确定

在 Analytics Python 函数中使用 Python

从 Analytics 中,使用 Analytics Python 函数调用您的 PYTHONPATH 中存在的脚本中的函数。

说明

如果您对 Python 脚本进行任何编辑,您必须刷新您的 Analytics 项目中的视图以使用最新版本的 Python 脚本。刷新视图的最简单的方式是关闭您正使用的表,然后重新打开。

ACL 脚本指南 14.1