Python Tableau datasources.publish用法及代码示例

Tableau Server Client (TSC)中datasources.publish的用法。

用法

datasources.publish(datasource_item, file_path, mode, connection_credentials=None)

将数据源发布到服务器，或将数据附加到现有数据源。

此方法检查数据源的大小，并自动确定是分多个部分发布数据源还是一次发布数据源。

REST API：Publish Datasource

参数

名字	说明
`datasource_item`	`datasource_item` 指定要添加的新数据源或要追加到的数据源。如果要添加新数据源，则需要使用现有项目的 `project_id` 创建新的 `datasource_item`。数据源的名称将是文件的名称，除非您在创建实例时还为新数据源指定了名称。见DatasourceItem。
`file_path`	要发布的数据源的路径和名称。
`mode`	指定您是发布新数据源 (`CreateNew`)、覆盖现有数据源 (`Overwrite`)，还是将数据附加到数据源 (`Append`)。如果要追加到数据源，则服务器上的数据源和要发布的数据源必须是数据提取(.tde 文件)，并且它们必须共享相同的架构。您还可以使用发布模式属性，例如：`TSC.Server.PublishMode.Overwrite`。
`connection_credentials`	(可选)连接到数据源所需的凭据。 `ConnectionCredentials` 对象包含数据源的身份验证信息(用户名和密码，以及凭据是嵌入的还是使用 OAuth)。

异常

错误	说明
`File path does not lead to an existing file.`	引发文件路径不正确或文件丢失的错误。
`Invalid mode defined.`	如果发布模式不是定义的选项之一，则会引发错误。
`Only .tds, tdsx, .tde, or .hyper files can be published as datasources.`	如果指定的文件类型不受支持，则引发错误。

添加或附加到的数据源的DatasourceItem。

示例


  import tableauserverclient as TSC
  server = TSC.Server('https://SERVERURL')

  ...

  project_id = '3a8b6148-493c-11e6-a621-6f3499394a39'
  file_path = r'C:\temp\WorldIndicators.tde'


  # Use the project id to create new datsource_item
  new_datasource = TSC.DatasourceItem(project_id)

  # publish data source (specified in file_path)
  new_datasource = server.datasources.publish(
                    new_datasource, file_path, 'CreateNew')

    ...

相关用法

注：本文由纯净天空筛选整理自tableau.github.io大神的英文原创作品 datasources.publish。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。