自从Tableau10.2发版，技术宅们欣喜若狂：Tableau中终于可以用Python啦！不过，究竟怎么用？很多用户就不是很清楚了。

关于Python在Tableau的用法，我查阅相关资料，找到了这篇内容完整并且满满干货的分享文章。英文原文链接接：tableau/TabPy

在这里，我将原文做了翻译，分享给技术达人们！

——————————————————————————————————》》

本期《举个栗子》，阿达要给大家分享的Tableau技巧是：如何在Tableau中用Python。

在Tableau中用Python，首先需要添加TabPy服务器。TabPy服务器是Tableau的Python集成的服务器组件，它是一个基于Tornado和其他Python库的Python进程。

一、在Linux / MacOS上安装

在基于Linux的系统上，您可以使用脚本setup.sh从头开始安装TabPy。

首先点击TabPy存储库着陆页右上角的绿色克隆或下载按钮并下载zip文件。解压缩后，导航到终端窗口中包含setup.sh的文件夹，然后键入./setup.sh。

在MacOSX上，您可能还需要通过键入以下命令来为文件授予权限：chmod + x setup.sh

该脚本执行以下操作：

下载并安装Anaconda，除非Anaconda在PATH或文件夹Anaconda在当前文件夹中找到。 Anaconda提供了一套详尽的Python包，包括可由服务器执行的Python代码使用的ML相关库。

创建一个名为Tableau-Python-Server的Python环境（如果尚不存在）。然后脚本激活环境，并将服务器文件夹添加到PYTHONPATH（这是服务器脚本在同一个文件夹中查找其Python依赖项所必需的）。

将所需的Python包安装到新环境以及客户端软件包中，因为它包含服务器所依赖的常用功能。

初始化服务器，显示安装位置和下次启动服务的说明。

安装完成后，或根据启动服务器的说明运行startup.sh时，应该会看到如下输出：

INFO：__ main __：{“INFO”：“Loading state from state file”}

INFO：__ main __：{“INFO”：“Initializing tabpy”}

INFO：__ main __：{“INFO”：“Done initializing tabpy”}

INFO：__ main __：{“INFO”：“Web service listening on port 9004”}

此时，服务器可以远程执行Python代码或部署Python函数。

您可以通过终止进程来停止服务器（例如，使用CTRL-C）。

二、在Windows上安装

在Windows上，您可以使用脚本setup.bat从头开始安装TabPy。

首先点击TabPy存储库着陆页右上角的绿色克隆或下载按钮并下载zip文件。解压缩后，使用Windows命令行导航到包含setup.bat的文件夹，然后键入setup.bat。

脚本执行以下步骤：

下载并安装Anaconda，在当前用户帐户下，例如C：\ users \ yourUserName \，除非Anaconda在PATH中或具有注册表项。 Anaconda提供了一套详尽的Python包，包括可由服务器执行的Python代码使用的ML相关库。

创建一个名为Tableau-Python-Server的Python环境（如果尚不存在）。脚本然后激活环境。

将所需的Python包安装到新环境以及客户端软件包中，因为它包含服务器所依赖的常见功能。

初始化服务器，显示安装位置和下次启动服务的说明。

安装完成后，或者根据启动服务器的说明运行startup.bat时，应该会看到如下输出：

INFO：__ main __：{“INFO”：“Loading state from state file”}

INFO：__ main __：{“INFO”：“Initializing tabpy”}

INFO：__ main __：{“INFO”：“Done initializing tabpy”}

INFO：__ main __：{“INFO”：“Web service listening on port 9004”}

此时，服务器可以远程执行Python代码或部署Python函数。

您可以通过终止可以在Windows任务管理器中看到的python2.7进程来停止服务器。 （按Ctrl + Shift + Esc访问任务管理器）

三、手动安装

如果您熟悉Python环境并且已经设置了一个，或者不喜欢使用Anaconda，并且只想启动服务器进程，则可以跳过安装脚本，安装依赖项并直接从命令行运行该进程。手动安装说明假定Conda或Python被定义为PATH的一部分。

它是可选的，但建议您为此项目创建一个新的Conda环境：

conda create --name Tableau-Python-Server python = 2.7 anaconda

上面的示例创建了一个Python 2.7环境，但Python 2.7+和Python 3.5+都支持Tableau Python Server。

现在激活新创建的环境。

在Linux / MacOS上：

source Tableau-Python-Server

在Windows上：

activate Tableau-Python-Server

由于TabPy在PyPI上可用，您可以通过简单的运行以下命令进行安装。

pip install tabpy-server

随着软件包的安装，您将看到命令行中列出的安装位置。这些可能看起来像/Users/username/anaconda/envs/Tableau-Python-Server/lib/python2.7/site-packages或\ Users \ username \ anaconda \ envs \ Tableau-Python-Server \ lib \ site-packages，取决于你的环境。

导航到site-packages下的tabpy_server文件夹，并分别在Windows和Linux / MacOS上运行startup.bat或startup.sh。您可以指定自定义端口号作为参数。 startup.bat 9001。

【四】更新TabPy

您可以使用pip中的--upgrade选项来更新到较新版本。

pip install --upgrade tabpy-server

为了使其成功，如果您在Conda环境中安装了TabPy，请确保它处于活动状态。

【五】扩展环境

如果您的功能取决于未包含的Python软件包，则需要将它们安装到Python环境中，以使其可用于服务器进程。

以下代码段假设您已经运行setup.sh或setup.bat，它创建了一个Conda环境，并在该环境中启动了服务器进程。

通过添加包名称，它可用于在服务器中执行的任何Python代码：

在Linux / MacOS上：

/Anaconda/bin/source activate Tableau-Python-Server

pip install _names_of_packages_here_

在Windows上：

/ Anaconda / Scripts / activate Tableau-Python-Server

pip install _names_of_packages_here_

如果您在默认的Python框架中安装了没有Anaconda的TabPy，那么您可以通过以下方式实现：

pip install _names_of_packages_here_

您可以在服务器进程运行时在单独的终端中执行此操作 - 无需重新启动。

【六】REST接口

服务器进程暴露了几个REST API以获取状态并执行Python代码并查询已部署的方法。

1、http：get :: / info

获取有关服务器的静态信息。

☞示例请求：

  GET /info HTTP/1.1

    Host: localhost:9004

    Accept: application/json

☞响应示例：

    HTTP / 1.1 200 OK

    Content-Type：application / json

    {“description”：“”，

    “creation_time”：“0”，

    “state_path”：“/ Users / username / my-server-state-folder”，

    “server_version”：“dev”，

    “name”：“my-server-name”}

description是在state.ini文件中硬编码的字符串，可以在那里编辑。

creation_time是自1970-01-01以来的创建时间（以秒为单位），硬编码在state.ini文件中，可在其中进行编辑。

state_path是服务器的状态文件路径（服务器启动时环境变量TABPY_STATE_PATH的值）。

server_version是由服务器提供的硬编码字符串（在server / common / config.py中定义）。客户可以使用此信息进行兼容性检查。

☞使用卷曲

    curl -X GET http：// localhost：9004 / info

2、http：get :: / status

获取部署端点的运行时状态。如果在服务器中未部署端点，则返回的数据是空的JSON对象。

☞示例请求：

    GET /status HTTP/1.1

    Host: localhost:9004

    Accept: application/json

☞响应示例：

    HTTP / 1.1 200 OK

    Content-Type：application / json

{"clustering": {

      "status": "LoadSuccessful",

      "last_error": null,

      "version": 1,

      "type": "model"},

    "add": {

      "status": "LoadSuccessful",

      "last_error": null,

      "version": 1,

      "type": "model"}

    }

☞使用卷曲：

    curl -X GET http：// localhost：9004 / status

3、http：get :: / endpoints

获取部署的端点及其静态信息的列表。如果在服务器中未部署端点，则返回的数据是空的JSON对象。

☞示例请求：

  GET /endpoints HTTP/1.1

    Host: localhost:9004

    Accept: application/json

☞响应示例：

    HTTP / 1.1 200 OK

    Content-Type：application / json

{"clustering":

      {"description": "",

      "docstring": "-- no docstring found in query function --",

      "creation_time": 1469511182,

      "version": 1,

      "dependencies": [],

      "last_modified_time": 1469511182,

      "type": "model",

      "target": null},

    "add": {

      "description": "",

      "docstring": "-- no docstring found in query function --",

      "creation_time": 1469505967,

      "version": 1,

      "dependencies": [],

      "last_modified_time": 1469505967,

      "type": "model",

      "target": null}

    }

☞使用卷曲：

    curl -X GET http：// localhost：9004 / endpoints

4、http：get :: / endpoints /：endpoint

获取特定部署端点的描述。端点必须首先部署在服务器中。

☞示例请求：

    GET /endpoints/add HTTP/1.1

    Host: localhost:9004

    Accept: application/json

☞响应示例：

    HTTP / 1.1 200 OK

    Content-Type：application / json 

{"description": "", "docstring": "-- no docstring found in query function --",

    "creation_time": 1469505967, "version": 1, "dependencies": [],

    "last_modified_time": 1469505967, "type": "model", "target": null}

☞使用卷曲：

    curl -X GET http：// localhost：9004 / endpoints / add

6、http：post :: / evaluate

执行一个Python代码块，用提供的值替换命名参数。

预期的POST主体是一个带有两个元素的JSON字典：

包含传递给代码的参数值的值的关键数据data。这些值是按键名称（_arg1，_arg2等）的特定约定的键值对。

包含Python代码（一行或多行）的值的关键脚本scritp。对参数名称的任何引用将根据数据被其值替代。

☞示例请求：

  POST /evaluate HTTP/1.1

    Host: localhost:9004

    Accept: application/json

    {"data": {"_arg1": 1, "_arg2": 2}, "script": "return _arg1+_arg2"}

☞响应示例：

    HTTP / 1.1 200 OK

    Content-Type：application / json

    3

☞使用卷曲：

    curl -X POST http：// localhost：9004 / evaluate \

    -d'{“data”：{“_arg1”：1，“_arg2”：2}，“script”：“return _arg1 + _arg2”}'

可以通过预定义的函数tabpy.query从代码块中调用已部署的函数。此函数的工作方式与客户端库的查询方法类似，并返回相应的数据结构。该功能必须首先作为服务器端点部署。

☞以下示例在部署deploy-function部分时调用端点集群：

    POST /evaluate HTTP/1.1

    Host: http://example.com

    Accept: application/json

    { "data":

      { "_arg1": [6.35, 6.40, 6.65, 8.60, 8.90, 9.00, 9.10],

        "_arg2": [1.95, 1.95, 2.05, 3.05, 3.05, 3.10, 3.15]

      },

      "script": "return tabpy.query('clustering', x=_arg1, y=_arg2)"}

☞下一个示例显示如何使用curl从终端调用评估;此代码查询部署在deploy-function中的方法add：

    curl -X POST http：// localhost：9004 / evaluate \

    -d'{“data”：{“_arg1”：1，“_arg2”：2}，

        “script”：“return tabpy.query（\”add \“，x = _arg1，y = _arg2）[\”response \“]”}'

7、http：post :: / query /：endpoint

在指定的端点执行一个函数。该功能必须首先部署。

该界面希望具有数据键的JSON体，根据其原始定义指定函数的值。在下面的例子中，函数聚类被定义为两个参数x和y的签名，期望数字数组。

☞示例请求：

    POST / query / clustering HTTP / 1.1

    Host：localhost：9004

    Accetp：application / json

    {“data”：{

      “x”：[6.35，6.40，6.65，8.60，8.90，9.00，9.10]，

      “y”：[1.95，1.95，2.05，3.05，3.05，3.10，3.15]}}

☞响应示例：

    HTTP / 1.1 200 OK

    Content-Type：application / json

    {“model”：“clustering”，“version”：1，“response”：[0，0，0，1，1，1，1]

    “uuid”：“46d3df0e-acca-4560-88f1-67c5aedeb1c4”}

☞使用卷曲：

    curl -X GET http：// localhost：9004 / query / clustering -d \

    '{“data”：{“x”：[6.35，6.40，6.65，8.60，8.90，9.00，9.10]，

              “y”：[1.95，1.95，2.05，3.05，3.05，3.10，3.15]}}'

今天的Tableau技巧你Get到了吗？赶快打开你的Tableau试试看吧！

文章部分信息来源于网络，如有侵权请告知