On January 27, 2021, Google is changing the required permissions for attaching IAM roles to service accounts. If you are using IAM roles for your Google service accounts, please see Changes to User Management.
NOTE: For file-based sources, Cloud Dataprep by TRIFACTA® INC. expects that each row of data in the import file is terminated with a consistent newline character, including the last one in the file.
For single files lacking this final newline character, the final record may be dropped.
NOTE: For file-based external datastores, the following limitations apply:
- Only the first 10,000 files can be retrieved.
- The first sample is pulled from a maximum of the first 100 files in the directory. If the size of these 100 files is less than 10MB, the Transformer page indicates that this represents the full dataset.
- When imported, the size computation reported in the Flow View page is over the first 10,000 files.
- Jobs are run across all files in the directory, even if there are more than 10,000 files.
NOTE: An imported dataset requires about 15 rows to properly infer column data types and the row, if any, to use for column headers.
File and path limitations:
- The colon character (
:) cannot appear in a filename or a file path.
- Filenames cannot begin with special characters like dot (
.) or underscore(
1. Connect to sources
NOTE: Compressed files are recognized and can be imported based on their file extensions.
Upload: Cloud Dataprep by TRIFACTA® INC. can also load files from your local file system.
Tip: You can drag and drop files from your desktop to to upload them.
NOTE: You can upload a file up to 1 GB in size.
NOTE: When you upload an updated version of a previously uploaded file, the new file is stored as a separate upload altogether. In your flow, you must swap out the old dataset to point to the new one.
To change your upload location, click Edit. Navigate to the preferred Google Cloud Storage location.
Google Cloud Storage: Browse or search your Google Cloud Storage files to select content for import. See Google Cloud Storage Browser.
BigQuery: Browse your BigQuery instance for tables to import as datasets.
If you have read permissions for multiple projects, you can read from tables that are part of other projects. See BigQuery Browser.
NOTE: When working with datasets sourced from Avro files, lineage information and the SOURCEROWNUMBER function are not supported.
Databases: If connected to a relational datastore, you can load tables or views from your database. See Database Browser.
NOTE: For long-loading relational sources, you can monitor progress through each stage of ingestion. After these sources are ingested, subsequent steps to import and wrangle the data may be faster.
For more information, see Overview of Job Monitoring.
Google Sheets: Browse or search your Google Drive for Google Sheets to import.
- Cloud Dataprep Premium by TRIFACTA INC.
- Trifacta Wrangler Enterprise
NOTE: You must enable access to your Google Drive. No other Google Drive data is read for import.
For more information on the supported input formats, see Supported File Formats.
New/Edit: Click to create or edit a connection. By default, the displayed connections support import.
Search: Enter a search term to locate a specific connection.
2. Add datasets
When you have found your source directory or file:
You can hover over the name of a file to preview its contents.
NOTE: Preview may not be available for some sources, such as Parquet.
Click the Plus icon next to the directory or filename to add it as a dataset.
Tip: You can import multiple datasets at the same time. See below.
Excel files: Click the Plus icon next to the parent workbook to add all of the worksheets as a single dataset, or you can add individual sheets as individual datasets. See Import Excel Data.
If custom SQL query is enabled, you can click Create Dataset with SQL to enter a customized SQL statement to pre-filter the table within the database to include only the rows and columns of interest.
For more information, see Create Dataset with SQL.
If parameterization has been enabled, you can apply parameters to the source paths of your datasets to capture a wider set of sources. Click Create Dataset with Parameters. See Create Dataset with Parameters.
3. Configure selections
When a dataset has been selected, the following fields appear on the right side of the screen. Modify as needed:
- Dataset Name: This name appears in the interface.
Dataset Description: You may add an optional description that provides additional detail about the dataset. This information is visible in some areas of the interface.
Tip: Click the Eye icon to inspect the contents of the dataset prior to importing.
You can select a single dataset or multiple datasets for import.
You can modify settings used during import for individual files. In the card for an individual dataset, click Edit Settings.
NOTE: In some cases, there may be discrepancies between row counts in the previewed data versus the data grid after the dataset has been imported, due to rounding in row counts performed in the preview.
- Per-file encoding: By default, Cloud Dataprep by TRIFACTA INC. attempts to interpret the encoding used in the file. In some cases, the data preview panel may contain garbled data, due to a mismatch in encodings. In the Data Preview dialog, you can select a different encoding for the file. When the correct encoding is selected, the preview displays the data as expected.
- Detect structure: By default,
Cloud Dataprep by TRIFACTA INC. attempts to interpret the structure of your data during import. This structuring attempts to apply an initial tabular structure to the dataset.
- Unless you have specific problems with the initial structure, you should leave the Detect structure setting enabled. Recipes created from these imported datasets automatically include the structuring as the first, hidden steps. These steps are not available for editing, although you can remove them through the Recipe panel. See Recipe Panel.
- When detecting structure is disabled, imported datasets whose schema has not been detected are labeled, unstructured datasets. When recipes are created for these unstructured datasets, the structuring steps are added into the recipe and can be edited as needed.
- For more information, see Initial Parsing Steps.
Remove special characters from column names: When selected, characters that are not alphanumeric or underscores are stripped, and space characters are converted to underscores.
For more information, see Sanitize Column Names.
- Column data type inference: You can choose whether or not to apply Trifacta type inference to your individual dataset.
- In the preview panel, you can see the data type that is to be applied after the dataset is imported. This data type may change depending on whether column data type inference is enabled or disabled for the dataset.
To enable Trifacta type inference, select the Column Data Type Inference checkbox.
Tip: To see the effects of Trifacta type inference, you can toggle the checkbox and review data type listed at the top of individual columns. To override an individual column's data type, click the data type name and select a new value.
4. Import selections
If you have selected a single dataset for import:
- Click Continue. The dataset is imported.
- A recipe is created for it, added to a new flow, and loaded in the Transformer page for wrangling. See Transformer Page.
You can import multiple datasets from multiple sources at the same time. In the Import Data page, continue selecting sources, and additional dataset cards are added to the right panel.
NOTE: If you are importing from multiple files at the same time, the files are not necessarily read in a regular or predictable order.
NOTE: When you import a dataset with parameters from multiple files, only the first matching file is displayed in the right panel.
In the right panel, you can see a preview of each dataset and make changes as needed.
If you have selected multiple datasets for import:
- To import the selected datasets, click Continue.
The datasets are imported and added to a new flow.
NOTE: To rename this flow, click
Untitledat the top of Flow View.
Tip: To begin transforming one of these datasets, select it. From its context menu, select Add new recipe. Select the recipe. In the context panel on the right, select Edit Recipe. See Transformer Page.
For more information, see Flow View Page.
- To remove a dataset from import, click the X in the dataset card.
This page has no comments.