---
schema_version: "1"
id: b44afa451ef527de8a7f013c741122336522a37d838d65dbc9caf768bfca21f4
title: tsm data-access
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/server/cli_data-access.md
canonical_url: https://help.tableau.com/v0.0/server/zh-cn/cli_data-access.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 7b63f903b6c9fc227126396eccc010102c81a410811bf76a10e696c86209534c
description: Reference for tsm data-access commands to configure caching, repository access, SAML, and WDCs.
---
[跳转到主要内容](#main-content)

# tsm data-access

您可以使用 `tsm data-access` 命令配置数据缓存、启用或禁用数据存储库访问、为单点登录启用 SAML，以及配置 Web 数据连接器 (WDC) 设置。

- caching
    - [data-access caching list](#caching-list)
    - [data-access caching set](#caching-set)
- repository
    - [repository-access disable](#repository-access-disable)
    - [repository-access enable](#repository-access-enable)
    - [repository-access list](#repository-access-list)
- set-saml-delegation
    - [set-saml-delegation configure](#set-saml-config)
    - [set-saml-delegation disable](#set-saml-disable)
    - [set-saml-delegation enable](#set-saml-enable)
- web-data-connectors
    - [web-data-connectors add](#web-data-connectors-add)
    - [web-data-connectors allow](#web-data-connectors-allow)
    - [web-data-connectors delete](#web-data-connectors-delete)
    - [web-data-connectors list](#web-data-connectors-list)

## tsm data-access caching list

显示数据连接缓存设置。若要详细了解数据连接缓存设置，请参见[配置数据缓存](https://help.tableau.com/v0.0/server/zh-cn/config_cache.htm)。

### 概要

`tsm data-access caching list [global options]`

## tsm data-access caching set

设定数据连接缓存设置。若要详细了解数据连接缓存设置，请参见[配置数据缓存](https://help.tableau.com/v0.0/server/zh-cn/config_cache.htm)。

### 概要

`tsm data-access caching set [options] [global options]`

### 选项

\-r, --refresh-frequency

可选。

设置使用对基础数据源的新查询刷新缓存数据的频率。您可以指定一个数字，定义应将数据缓存的最长时间（分钟）。您还可以指定 **low** 以尽可能长时间缓存和重用数据，或指定 **always**（相当于 **0**）以在每次加载页面时刷新数据。如果未指定此选项，其默认值为 **low**。

## tsm data-access repository-access disable

为默认远程用户禁用对 Tableau PostgreSQL 数据库的外部访问。这将不会禁用从 localhost 进行的访问。

### 概要

`tsm data-access repository-access disable [options] [global options]`

### 选项

\--repository-username <username>

必需。

具有数据存储库访问权限的用户名（**tableau** 或 **readonly**）。

\--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。默认值为 1500（25 分钟）。

\--ignore-prompt

可选。

隐藏重新启动提示并重新启动 Tableau Server。

## tsm data-access repository-access enable

启用对 Tableau PostgreSQL 数据库的访问。

默认情况下，PostgreSQL 流量使用端口 8060 (TCP)。如果运行本地防火墙，请确保为此端口允许流量。若要更改 PostgreSQL 端口，请参见[非动态映射的端口](https://help.tableau.com/v0.0/server/zh-cn/ports.htm#PortsNotDynamic)。

### 概要

`tsm data-access repository-access enable [options] [global options]`

### 选项

\--repository-password <password>

必需。

设置（或更改）用于访问指定用户名的数据存储库的密码。

\--repository-username <username>

必需。

具有数据存储库访问权限的用户名（**tableau** 或 **readonly**）。

\--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。默认值为 1500（25 分钟）。

\--ignore-prompt

可选。

隐藏重新启动提示并重新启动 Tableau Server。

## tsm data-access repository-access list

列出具有 Tableau PostgreSQL 数据库访问权限的用户。

### 概要

`tsm data-access repository-access list [global options]`

## tsm data-access set-saml-delegation configure

为 SAML SAP HANA 设置单点登录，使 Tableau Server 能够充当为进行 SAP HANA 数据连接的用户提供单点登录的身份提供程序 (IdP)。

### 概要

`tsm data-access set-saml-delegation configure [options] [global options]`

### 选项

\-kf, --cert-key <cert-key>

可选。

SAML 证书密钥文件。

\-cf, --cert-file <file-path>

可选。

SAML 证书文件的位置。

\-uf, --username-format <username-format>

可选。

用户名格式。有效的格式键包括：“username”、“domain\_and\_username”和“email”。

\-uc,--username-case <username-case>

可选。

用户名大小写。有效的大小写键包括：“lower”、“upper”和“preserve”。

.

## tsm data-access set-saml-delegation disable

为 SAML SAP HANA 禁用单点登录。

### 概要

`tsm data-access set-saml-delegation disable [global options]`

## tsm data-access set-saml-delegation enable

为 SAML SAP HANA 启用单点登录。

### 概要

`tsm data-access set-saml-delegation enable [global options]`

## tsm data-access web-data-connectors add

将 Web 数据连接器 (WDC) 添加到 WDC 安全列表。

### 概要

`tsm data-access web-data-connectors add [options] [global options]`

### 选项

\-n, --name <name>

必需。

将显示在 Tableau Server 数据源列表中的 WDC 的名称。此名称必须括在单引号 (') 或双引号 (") 中。如果名称包含空格，请使用双引号 (")。

\-sec, --secondary <secondary-URL-1>, <secondary-URL-2>

如果 WDC 使用辅助域，则为必需。

逗号分隔的 URL 列表，用于指明连接器可以向哪些域进行请求或从中接收数据，例如外部 JavaScript 库、REST API 或本地文件。不要将 URL 括在引号中。若要将整个域添加到辅助安全列表，您可以在 URL 结尾使用通配符表达式 `.*`，如下例所示：`https://www.example.com/.*`

请注意，在 Windows 上，可以围绕 `(.*)` 通配符包含括号，但没有必要。在 Linux 上，括号将导致错误。使用 `.*` 作为通配符。

如果您不知道 WDC 是否使用辅助域，或者不知道辅助域是什么，您可能需要联系 WDC 的开发人员。您还可以选择使用 `http://.*` 和`https://.*` 通配符 URL 以允许所有域。但是，为了提高安全性，我们强烈建议您使用更具体的 URL。

\--url <URL>

必需。

WDC 的 URL（格式为 `<scheme>://<host>:<port>/<path>`，例如 `https://www.tableau.com:443/example/`）。对于多个 WDC，<port> 值为 443（即用于 HTTPS 的默认端口），但您可以通过在 Tableau Server 或 Tableau Cloud 上查看数据源详细信息来检查适用于您的连接器的值。请注意，对于 WDC，不能使用通配符 (`.*`) 作为 URL 的一部分。

## tsm data-access web-data-connectors allow

启用或禁用 WDC 刷新。此外，还可在 Tableau Server 上允许或禁止使用 WDC。

### 概要

`tsm data-access web-data-connectors allow [options] [global options]`

### 选项

使用一个或两个选项。至少需要或 `--refreshes` 或 `--type` 其中之一。

\-r, --refreshes <refreshes-allowed>

如果已指定 `--type`，则为可选。

设置为 `false` 以不允许 WDC 刷新，或设置为 `true` 以允许 WDC 刷新。

\-t, --type <WDC-allowed>

如果已指定 `--refreshes`，则为可选。

设置为 `none` 以不允许在 Tableau Server 上使用 WDC（并从备份中忽略 WDC），或设置为 `all` 以允许使用 WDC。

## tsm data-access web-data-connectors delete

从 Tableau Server 安全列表中删除指定 WDC 或所有 WDC。

### 概要

`tsm data-access web-data-connectors delete [options] [global options]`

### 选项

\--all

可选。

此选项将删除所有 WDC。

\--url <URL>

可选。

要删除的 WDC 的 URL。

## tsm data-access web-data-connectors list

列出当前位于安全列表上的所有 WDC。

### 概要

`tsm data-access web-data-connectors list [options] [global options]`

### 选项

## 全局选项

\-h, --help

可选。

显示命令帮助。

\-p, --password <password>

在会话不是活动状态的情况下为必需，`-u` 或 `--username` 也为必需。

为在 `-u` 或 `--username` 中指定的用户指定密码。

如果密码包括空格或特殊字符，请将其括在引号中：

`--password "my password"`

\-s, --server https://<hostname>:8850

可选。

对 Tableau 服务管理器使用指定的地址。URL 必须以 `https` 开头，包括端口 8850，并使用服务器名称（而不是 IP 地址）。例如，`https://<tsm_hostname>:8850`。如果没有指定服务器，则假定为 `https://<localhost | dnsname>:8850`。

\--trust-admin-controller-cert

可选。

使用此标志来信任 TSM 控制器上的自签名证书。有关证书信任和 CLI 连接的详细信息，请参见 [连接 TSM 客户端](https://help.tableau.com/v0.0/server/zh-cn/tsm_overview.htm#Connecti)。

\-u, --username <user>

在会话不是活动状态的情况下为必需，`-p` 或 `--password` 也为必需。

指定用户帐户。如果未包括此选项，则使用您登录所使用的凭据运行该命令。