Page tree

Trifacta Wrangler Pro is no longer available. This space will be removed soon. Please visit this page instead: Workspace Settings Page

   


Contents:


The following settings can be customized for the user experience in your workspace. When you modify a setting, the change is immediately applied to the workspace. To access the page, select User menu > Admin console > Workspace settings.

NOTE: Users may not experience the changed environment until each user refreshes the application page or logs out and in again.

Enablement Options:

NOTE: Any values specified in the Workspace Settings page applies exclusively to the specific workspace and override any system-level defaults.

OptionDescription
Default

The default value is applied. This value may be inherited from higher level configuration.

Tip: You can review the default value as part of the help text.

Enabled

The setting is enabled.

NOTE: If the setting applies to a feature, the feature is enabled. Additional configuration may be required. See below.

DisabledThe setting is disabled.
EditClick Edit to enter a specific value for the setting.

General

Allow listing users

When enabled, individual users review and select from a list of all users in the Trifacta application.

NOTE: When this feature is disabled, users can access other users by providing the login email address of other users in screens such as the sharing dialogs.

Locale

Set the locale to use for inferring or validating data in the application, such as numeric values or dates. The default is United States.

NOTE: After saving changes to your locale, refresh your page. Subsequent executions of the data inference service use the new locale settings.

For more information, see Locale Settings.

Session duration

Specify the length of time in minutes before a session expires. Default is 10080 (one week).

Storage directories

Allow members of the workspace to change paths to their upload and output results locations through their user profile.

For more information, see Storage Config Page.

User messaging

When enabled, workspace users can explore content through the Trifacta application.

Users can also begin in-app conversations with Trifacta Support.

API

API Access Token

When accessing the REST APIs, you can optionally use a token for simpler use and enhanced security.

NOTE: This feature may not be available in all environments.

NOTE: API access tokens must be enabled to use the API reference documentation available through the User menu.

For more information, see Access Tokens Page.

Allow users to generate access tokens

When enabled, individual workspace users can generate their own personal access tokens, which enable access to REST APIs. For more information, see Manage API Access Tokens.

Maximum lifetime for user generated access tokens (days)

Defines the maximum number of days that a user-generated access token is permitted for use in the product.

Tip: To permit generation of access tokens that never expire, set this value to -1.

For more information, see Manage API Access Tokens.

Connectivity

Custom SQL query

When enabled, users can create custom SQL queries to import datasets from relational tables.


Enable conversion of standard JSON files via conversion service

When enabled, the Trifacta application utilizes the conversion service to ingest JSON files and convert them to a tabular format that is easier to import into the application. For more information see Working with JSON v2.

NOTE: This feature is enabled by default but can be disabled as needed. The conversion process performs cleanup and re-organization of the ingested data for display in tabular format.

When disabled, the Trifacta application uses the old version of JSON import, which does not restructure the data and may require additional recipe steps to manually structure it into tabular format.

NOTE: The legacy version of JSON import is required if you are working with compressed JSON files or only Newline JSON files.

NOTE: Although imported datasets and recipes created under v1 of the JSON importer continue to work without interruption, the v1 version is likely to be deprecated in a future release. You should switch your old imported datasets and recipes to using the new version. Instructions to migrate are provided at the link below.

For more information, see Working with JSON v1.


Flows, recipes and plans

Collaborative suggestions

If desired, you can enable the inclusion of suggestion cards that are generated from recent use of the Trifacta application. As the application gathers more information about how you or members of your workspace apply transformations to your data, the suggestions become more meaningful for the data that you are processing.

NOTE: No data is shared with Trifacta or any system outside of the Trifacta platform.

These collaborative suggestion cards can be generated from individual usage or from workspace level usage. These suggestions appear under the Recently Used heading in the side panel.When this feature is enabled, individual users can still choose to opt-out of sharing their usage data with this feature. See User Profile Page.

OptionDescription
disabledCollaborative suggestions are not surfaced in the application.
personalCollaborative suggestions are based on the individual user's previous transformations.
workspaceCollaborative suggestions are based on the transformations from all users in the workspace.
DefaultThe default setting for the workspace is applied.

For more information, see Overview of Predictive Transformation.

Column from examples

When enabled, users can access a tool through the column menus that enables creation of new columns based on example mappings from the selected column. For more information, see Overview of TBE.


Export

When enabled, workspace users are permitted to export their flows and plans. Exported flows can be imported into other workspaces or product editions. 

NOTE: If plans are been enabled in your workspace, enabling this flag applies to flows and plans.

For more information, see Export Flow.

For more information, see Export Plan.

Import

When enabled, workspace users are permitted to import exported flows and plans.

NOTE: If plans have been enabled in your workspace, enabling this flag applies to flows and plans.

For more information, see Import Flow.

For more information, see Import Plan.


Sample downloads

When enabled, members can download the contents of the Transformer page at any time. For an individual step, a member can download the current sample, as modified by the current recipe up to the point of the current step. For more information, see Recipe Panel.

Schematized output

When enabled, all output columns for all types of outputs are typecast to their annotated types. This feature is enabled by default.

For non-schematized outputs, Trifacta Wrangler Pro enforces casting of all values to the annotated data type of the column by default. For example, if the output value is -3.4 and the data type for the output column is Integer, the platform enforces Integer type casting and writes a null value instead.

  • true: All output values must match the data type of the output columns, or a null value is written.
  • false: All output values are written in their output form, regardless of the column's data type.

Sharing

When enabled, workspace users are permitted to share flows and plans with other users in the workspace.

NOTE: If plans have has been enabled in your workspace, enabling this flag applies to flows and plans.

For more information, see Share a Flow.

For more information, see Share a Plan.

Job execution

Combine Spark Transform and Profile jobs into one.

When enabled, the transform and profiling tasks of a job executed on the Spark running environment are combined. The profiling task is executed as a part of the transform task, which eliminates any time spent orchestrating the profiling task and accessing the profiler input file on storage.

NOTE: When these two tasks are combined, publishing actions are not undertaken if the profiling task fails.

In the Job Details page, combined jobs appear in a Transform with profile card. See Job Details Page.

Custom Spark Options Feature

When enabled, users can override Spark configuration options for output objects before running Spark jobs.

Tip: When enabled, a default set of Spark configuration options is available for users. Additional properties can be specified through the Spark Whitelist Properties setting.



Logical and physical optimization of jobs

When enabled, the Trifacta application attempts to optimize job execution through logical optimizations of your recipe and physical optimizations of your recipes interactions with data.

This workspace setting can be overridden for individual flows. For more information, see Flow Optimization Settings Dialog.

SQL Scripts

When enabled, users may define SQL scripts to execute as part of a job's run. Scripts can be executed before data ingestion, after output publication, or both through any write-supported relational connection to which the user has access.

For more information, see Create Output SQL Scripts.

Photon execution

When enabled, users can choose to execute their jobs on Trifacta Photon, a proprietary running environment built for execution of small- to medium-sized jobs in memory on the Trifacta node.

Tip: When enabled, you can select to run jobs on Photon through the Run Jobs page. The default running environment is the one that is best for the size of your job.

When Trifacta Photon is disabled:

  • You cannot run jobs on the local running environment. All jobs must be executed on a clustered running environment.
  • Trifacta Photon is used for Quick Scan sampling jobs. If Trifacta Photon is disabled, the Trifacta application attempts to run the Quick Scan job on another available running environment. If that job fails or no suitable running environment is available, the Quick Scan sampling job fails.

For more information, see Run Job Page.

Scheduling and parameterization



Publishing

Avro output format

When enabled, members can generate outputs in Avro format.

CSV output format

When enabled, members can generate outputs in CSV format.

Hyper output format

When enabled, members can generate outputs in Hyper format for publication and use on Tableau Server.

JSON output format

When enabled, members can generate outputs in JSON format.

Parquet output format

When enabled, members can generate outputs in Parquet format.

Notifications

Email notifications

When enabled, Trifacta Wrangler Pro can send email notifications to users based on the success or failure of jobs. 

Email notifications: on job failure

When email notifications are enabled, you can configure the default setting for the types of failed jobs that generate an email to interested stakeholders. The value set here is the default value for each flow in the workspace.

Settings:

SettingDescription
NeverEmail notifications are never sent for job failures.
ScheduledNotifications are sent only when scheduled jobs fail.
Ad hoc

Notifications are sent only when ad-hoc (manually executed) jobs fail.

AllNotifications are sent for all job failures.
DefaultNotifications are sent based on the default settings for the product.

Default setting for job failures is scheduled.

Individual users can opt out of receiving notifications or configure a different email address. See Email Notifications Page

Emailed stakeholders are configured by individual flow. For more information, see Manage Flow Notifications Dialog.

Email notifications: on job success

When email notifications are enabled, you can configure the default setting for the types of successful jobs that generate an email to interested stakeholders. The value set here is the default value for each flow in the workspace.

For more information on the settings, see the previous section. Default setting is never.

Individual users can opt out of receiving notifications or configure a different email address. See Email Notifications Page.

Emailed stakeholders are configured by individual flow. For more information, see Manage Flow Notifications Dialog.

Email notifications: on plan/flow share

When email notifications are enabled, users automatically receive notifications whenever an owner shares the plan or flow with the user.

Individual users can opt out of receiving notifications. For more information, see Preferences Page.

Experimental features

These experimental features are not supported. 

Experimental features are in active development. Their functionality may change from release to release, and they may be removed from the product at any time. Do not use experimental features in a production environment.

These settings may or may not change application behavior.

Default language

NOTE: This experimental feature is not available unless you have been provided a custom build of the Trifacta platform for deployment. Otherwise, this setting does nothing.

Select the default language to use in the Trifacta application.

Language localization

NOTE: This experimental feature is not available unless you have been provided a custom build of the Trifacta platform for deployment. Otherwise, this setting does nothing.

When enabled, the Trifacta application is permitted to display text in the selected language. 

Show user language preference

NOTE: This experimental feature is not available unless you have been provided a custom build of the Trifacta platform for deployment. Otherwise, this setting does nothing.

When enabled, users are permitted to select a preferred language in their preferences. See Preferences Page.


This page has no comments.