Configure Photon Client
Trifacta Photon client is the in-browser engine for management of sampling and transformation in the Transformer page. This section describes configuration options for Trifacta Photon.
Trifacta Photon is automatically downloaded and updated in each user's web browser when accessing the Transformer page. Within the browser, Photon is used to manage sampling and to process transformations on those samples on the local web client, which limits required interactions with the Trifacta node.
Features:
Larger sample sizes (up to 10MB by default).
Note
Since Trifacta Photon supports larger sample sizes, some interactions may be slightly impacted. Loading states have been introduced to enable faster responsiveness from the application.
Tip
For datasets that are smaller than the sample size limit, the Transformer Page displays the entire dataset in its transformed state. So, you can download the dataset from the Recipe Panel in Transformer Page without having to execute it on a remote server. This expanded capability allows for faster and more immediate local use of the product. See Recipe Panel.
This section contains the user-facing configuration for the Trifacta Photon client. Except as noted below, these configuration changes are applied to the Trifacta node, which then applies the configuration to each instance of the Trifacta Photon client and its interactions with the node.
Note
Some configuration is shared with the Trifacta Photon running environment. For more information, see Configure Photon Running Environment.
Limitations
None
Recommended Photon Configuration by Core Count
On the Trifacta node, you can make adjustments to the resources claimed by the Photon running environment based on the number of cores on the machine. The following table identifies the recommended settings for a node with 8, 16, or 32 cores. The default settings assume 16 cores.
Parameter | 8 cores | 16 cores (default) | 32 cores |
|---|---|---|---|
webapp.numProcesses | 2 | 2 | 5 |
vfs-service.numProcesses | 2 | 2 | 3 |
photon.numThreads | 2 | 4 | 4 |
batchserver.workers.photon.max | 2 | 2 | 4 |
The number of simultaneous users is a competing factor.
For a high number, more resources should be reserved for the webapp and the VFS services.
For a low number, more resources for Photon should improve performance for sampling and job execution on the Trifacta Photon running environment.
The following table illustrates some adjustments for a 16-core system:
Parameter | 16 cores (default) | Low number of simultaneous users | High number of simultaneous users |
|---|---|---|---|
webapp.numProcesses | 2 | 1 | 4 |
vfs-service.numProcesses | 2 | 1 | 4 |
photon.numThreads | 4 | 4 | 4 |
batchserver.workers.photon.max | 2 | 2 | 2 |
Modify Limits
Note
Increasing these values can have a significant impact on load times and performance. Change these values only if you are experiencing difficulties. Make incremental changes.
Sample Size Limits
You can configure the default and maximum permitted size of samples downloaded to the browser. For more information, see Configure Application Limits.
Maximum Data in the Client
The following parameter sets the upper limit on the number of bytes that can be delivered to the browser, which includes samples, metadata, and other data. Adding some kinds of transformations, such as joins or adding new columns, can grow the volume of data in the browser. This parameter represents the upper volume of data that can be displayed for a sample + transformations.
"webapp.client.maxResultsBytes": 41943040,
Tip
By default, the value for this parameter is four times the value of permitted sample sizes. If a user changes the permitted maximum size of samples delivered to the browser, then the total limit of maximum data in the client is set to 4x of the maximum permitted sample size.
Note
If the data volume of the same grows beyond this size, the number of rows available in the sample is reduced until the sample volume is below this threshold. This truncation happens automatically and without warning.
Use Photon Client
The Trifacta Photon client is an embedded component of the web client. Access to it is transparent to the user.
Configure VFS Service
Photon interacts with backend datastores through the VFS service.
Note
The VFS service is enabled by default and must be enabled when Trifacta Photon running environment is in use.
For more information, see Configure VFS Service.