1 | Exporting to Parquet requires imports for ParquetDatasetExport (shown), ParquetExportOptions and ParquetExportStats. |
2 | Exporting to TSON requires imports for TSONDatasetExport (shown), TSONExportOptions and TSONExportStats. |
3 | Importing from TSON requires imports for TSONDatasetImport (shown), TSONImportOptions and TSONImportStats. |
1 | Create a DatasetManager against a server in the cluster supplying a URI connection string (e.g. terracotta://<hostname>:<hostport>). |
2 | Create an ExportOptions instance corresponding to the desired file format (ParquetExportOptions in this example). |
3 | Specify the name of the dataset from which to export records (DS1 in this example). |
4 | Specify the Type of the dataset identified in 3 above. |
5 | Specify the full Path of an existing folder where the generated output file will be created and into which records will be written. |
6 | Create a DatasetExport instance corresponding to the desired format (ParquetDatasetExport in this example) supplying the DatasetManager and ExportOptions instances. |
7 | Perform the export by calling exportDataset(). |
8 | Understand the results of the completed export operation contained within the returned ExportStats instance (ParquetExportStats in this example): |
1 | Create a DatasetManager against a server in the cluster supplying a URI connection string (e.g. terracotta://<hostname>:<hostport>). |
2 | Create an ExportOptions instance corresponding to the desired file format (TSONExportOptions in this example). |
3 | Specify the name of the dataset from which to export records (DS1 in this example). |
4 | Specify the Type of the dataset identified in 3 above. |
5 | Specify the full path filename which the system will create and into which records will be written. The file's parent directory must exist. |
6 | Specify a named cell and its Type that is present in the dataset identified in 3 above. That cell will be used to filter the exported records. |
7 | Specify the low range numeric value of the filter cell for which records containing the specified filter cell and whose value is greater than or equal to the low range will be included in the export file. |
8 | Specify the high range numeric value of the filter cell for which records containing the specified filter cell and whose value is less than the high range will be included in the export file. |
9 | Create a DatasetExport instance corresponding to the desired format (TSONDatasetExport in this example) supplying the DatasetManager and ExportOptions instances. |
10 | Perform the export by calling exportDataset(). |
11 | Understand the results of the completed export operation contained within the returned ExportStats instance (TSONExportStats in this example): |
1 | Create a DatasetManager against a server in the cluster supplying a URI connection string (e.g. terracotta://<hostname>:<hostport>). |
2 | Create an ImportOptions instance corresponding to the desired file format (TSONImportOptions in this example). |
3 | Specify the name of an existing dataset into which records will be added (DS2 in this example). |
4 | Specify the Type of the dataset identified in 3 above. |
5 | Specify the full path filename of the file that you want to import. |
6 | Specify whether the input file identified in 5 above has been compressed (both ZIP and GZIP formats are supported). |
7 | Specify if all records present in the target dataset identified in 3 above should first be deleted before the new records are added from the import file. |
8 | Create a DatasetImport instance corresponding to the desired format (TSONDatasetImport in this example) supplying the DatasetManager and ImportOptions instances. |
9 | Perform the import by calling importDataset(). |
10 | Understand the results of the completed import operation contained within the returned ImportStats instance (TSONImportStats in this example): |