安装与设置 Datapane 支持库和 API。

安装

conda 或 pip 可以把 Datapane 的 Python 支持库与 CLI 安装至 macOS、Windows 、Linux。

Datapane 支持 Python 3.6 以上版本，Python 安装说明请参照 https://wiki.python.org/moin/BeginnersGuide/Download

conda

conda 安装命令如下：

$ conda install -c conda-forge datapane

pip

pip 安装命令如下：

$ pip3 install -U datapane

Windows 安装提示与疑难解答

在 Windows 中运行遇到问题？请参阅下文。

Windows 下，不建议用 pip 安装 Datapane，请用 conda ，conda 的优势在于安装依赖项更简单。

最新版 Windows 10 能自动安装 Python，只要在命令窗口中运行 python，就可以从 Windows 商店下载官方安装包。强烈建议安装 64 位版本的 Python，不要安装 32 位版本。在命令窗口运行 python -c "import struct; print(struct.calcsize('P')*8, 'bit')"，即可查看 Python 的版本。

python -c "import struct; print(struct.calcsize('P')*8, 'bit')"

注意，在 Windows 命令行中输入 datapane 或 datapane.exe， 都可以执行 datapane 命令。

Windows 中可能遇到的问题包括：

运行/导入 Datapane 时遇到导入（Import）错误

运行 Datapane，或在 Python 代码中导入 Datapane 时，可能会遇到 ImportError: DLL load failed 错误。

此时，请在微软官网下载安装 Visual C++ Redistributables for Windows（大多数时候要下载 x64 版本，即，vc_redist.x64.exe）。安装后，请再次运行。

Visual C++ 编译 pyarrow 时，遇到 Datapane 安装错误

运行 32 位 Python，并用 pip 安装时，可能会遇到此问题。用 conda 命令，或安装 64 位 Python （参照上文从 Windows 商店安装 Python 的说明） 可以解决此问题。

Windows 7 也会出现这个问题，我们直接支持 Windows 10，如果只能用 Windows 7，建议用 conda 安装。

'datapane.exe' is not recognized as an internal or external command（ datapane.exe 既不是内部命令也不是外部命令）

此问题是因为 Windows 路径（%PATH%) 中未包含 Python 文件夹，特别是 Scripts 文件夹。

Datapane 安装时可能会弹出如下（或类似）的提示：

The script datapane.exe is installed in 'C:\users\<USERNAME>\appdata\local\programs\python\python37\Scripts' which is not on PATH.
Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.

要修复这个问题，请在 %PATH% 中指定 pip 警告（请参阅 https://github.com/datapane/datapane-docs/tree/5f551e8c5b2748f0785683bbd62cb59f1dfe46ca/tutorials/here/README.md）里的 Scripts 路径。

用 python3.exe -m datapane.client 命令直接运行 Datapane 客户端，也可以解决这个问题。

遇到其它安装问题，请在 Datapane 论坛 里求助，那里有人提供帮助。

验证

Datapane 不仅是生成报告的本地 Python 框架，同时还提供了通过 CLI 和 Python 支持库访问的服务器组件，而且还需要 Token 验证。CLI 或 Python 支持库验证之后，所有来自 CLI 或 Python 支持库的请求都将自动验证。

Datapane 公众版

Datapane 公众版托管在 datapane.com ，并提供免费、公开的服务器发布与分享报告。API 与 CLI 默认使用此服务器。注册免费账户后，复制网页界面上的 API 密钥。然后，在 CLI 或 Python 支持库中用该密钥登陆。之后，所有来自 CLI 与 Python 支持库的请求都将自动验证。

# CLI
$ datapane login 
Enter your API Key: [paste your API key here]

---

#Python

import datapane as dp
dp.login(token=your_token)

Datapane 团队版

Datapane 团队版 支持私有托管服务器，并支持在公司内部署本地虚拟机。凭借管理员提供的凭证，就可以登陆虚拟机，如，https://your-company.datapane.net。

与公众版类似，主页上将显示 API 密钥，该密钥可用于 login 命令验证。这里需要传递完整的服务器 URL（包括 https://），示例如下：

# CLI

$ datapane login --server=https://[your-server].datapane.net
Enter your API Key: [把您的 API 密钥粘贴到这里]

---

# Python

import datapane as dp
dp.login(token=your_token, server='https://[your-server].datapane.net')

CLI 支持多账户登陆，使用 --env 标签，可以同时登陆公众版与团队版的虚拟机。

$ datapane --env public login
$ datapane --env acme login --server=https://acme.datapane.net

核查验证

运行以下命令检查登陆的账户：

# CLI

$ datapane ping

---

# Python

import datapane as dp
dp.ping()