PyMigrationPlanBuilder

class PyMigrationPlanBuilder

Bases: object

Default IMigrationPlanBuilder implementation.

__init__()

Default init.

Returns: None.

  • Return type: None

Methods

__init__() Default init.
append_default_extensions() Adds default hooks, filters, etc.
build() Finalizes the IMigrationPlan based on the current state.
clear_extensions() Clears all hooks, filters, mappings, and transformations.
for_server_to_cloud() Initializes the plan to perform a migration of content between a Tableau Server and Tableau Cloud site.
from_source(config) Sets or overwrites the configuration for the source endpoint to migrate content from.
from_source_tableau_server(server_url, ...) Sets or overwrites the configuration for the source Tableau Server site to migrate content from.
pipeline_profile() Gets the pipeline profile to execute.
skip_content_type(content_type[, pre_cache]) Configures the migration plan to skip migration of all items of a particular content type.
to_destination(config) Sets or overwrites the configuration for the destination endpoint to migrate content to.
to_destination_tableau_cloud(pod_url, ...[, ...]) Sets or overwrites the configuration for the destination Tableau Cloud site to migrate content to.
validate() Validates that the plan that would be built has enough information to execute.

Attributes

destination Gets the destination endpoint builder.
filters Gets the filters to execute at various points during the migration.
hooks Gets the hooks to execute at various points during the migration, determined by hook type.
mappings Gets the mappings to execute at various points during the migration.
options Gets the per-plan options to supply.
services Gets the migration service overrides.
source Gets the source endpoint builder.
transformers Gets the transformations to execute at various points during the migration.

property source : PyMigrationPlanEndpointBuilder

Gets the source endpoint builder.

property destination : PyMigrationPlanEndpointBuilder

Gets the destination endpoint builder.

property filters : PyContentFilterBuilder

Gets the filters to execute at various points during the migration.

property transformers : PyContentTransformerBuilder

Gets the transformations to execute at various points during the migration.

property options : PyMigrationPlanOptionsBuilder

Gets the per-plan options to supply.

property services : PyMigrationServiceBuilder

Gets the migration service overrides.

property hooks : PyMigrationHookBuilder

Gets the hooks to execute at various points during the migration, determined by hook type.

property mappings : PyContentMappingBuilder

Gets the mappings to execute at various points during the migration.

pipeline_profile()

Gets the pipeline profile to execute.

from_source_tableau_server(server_url, site_content_url, access_token_name, access_token, create_api_simulator=False, rest_api_version=None)

Sets or overwrites the configuration for the source Tableau Server site to migrate content from.

Args: : server_url: The base URL of the Tableau Server to connect to. site_content_url: The URL namespace of the site to connect to. access_token_name: The name of the personal access token to use to sign into the site. access_token: The personal access token to use to sign into the site. create_api_simulator: Whether or not to create an API simulator for the server_url. rest_api_version: The REST API version to use, or null to use the default version.

Returns: The same plan builder object for fluent API calls.

  • Parameters:
    • server_url (str)
    • site_content_url (str)
    • access_token_name (str)
    • access_token (str)
    • create_api_simulator (bool)
    • rest_api_version (str | None)
  • Return type: Self

to_destination_tableau_cloud(pod_url, site_content_url, access_token_name, access_token, create_api_simulator=False, rest_api_version=None)

Sets or overwrites the configuration for the destination Tableau Cloud site to migrate content to.

Args: : pod_url: The base URL of Tableau Cloud pod to connect to. site_content_url: The URL namespace of the site to connect to. access_token_name: The name of the personal access token to use to sign into the site. access_token: The personal access token to use to sign into the site. create_api_simulator: Whether or not to create an API simulator for the server_url. rest_api_version: The REST API version to use, or null to use the default version.

Returns: The same plan builder object for fluent API calls.

  • Parameters:
    • pod_url (str)
    • site_content_url (str)
    • access_token_name (str)
    • access_token (str)
    • create_api_simulator (bool)
    • rest_api_version (str | None)
  • Return type: Self

skip_content_type(content_type, pre_cache=True)

Configures the migration plan to skip migration of all items of a particular content type.

Args: : content_type: The content type to skip. pre_cache: True to find and map all source items so references in dependent content types can be efficiently updated. False to find and map items individually when they are referenced in dependent content types to avoid listing all items.

Returns: The same plan builder object for fluent API calls.

  • Parameters:
    • content_type (type)
    • pre_cache (bool)
  • Return type: Self

for_server_to_cloud()

Initializes the plan to perform a migration of content between a Tableau Server and Tableau Cloud site.

Returns: The same plan builder object for fluent API calls.

build()

Finalizes the IMigrationPlan based on the current state.

Returns: The created IMigrationPlan.

clear_extensions()

Clears all hooks, filters, mappings, and transformations.

Returns: The same plan builder object for fluent API calls.

  • Return type: Self

append_default_extensions()

Adds default hooks, filters, etc. that are common between all migration scenarios.

Returns: The same plan builder object for fluent API calls.

  • Return type: Self

from_source(config)

Sets or overwrites the configuration for the source endpoint to migrate content from.

Args: : config: The endpoint configuration.

Returns: The same plan builder object for fluent API calls.

  • Parameters: config (IMigrationPlanEndpointConfiguration)
  • Return type: Self

to_destination(config)

Sets or overwrites the configuration for the destination endpoint to migrate content to.

Args: : config: The endpoint configuration.

Returns: The same plan builder object for fluent API calls.

  • Parameters: config (IMigrationPlanEndpointConfiguration)
  • Return type: Self

validate()

Validates that the plan that would be built has enough information to execute.

Returns: The validation result.