JDBC Driver for Tableau CRM Analytics

Build 24.0.9060

Deleting Datasets

The driver offers the possibility to delete data from your Tableau CRM datasets.

Getting the metadata file

To delete data from an exisiting dataset, first you need to download the metadata file. You can download the metadata file during the process of creating a new dataset by performing the following steps:
  1. In Tableau CRM, go to the home page, click Create, and then choose Dataset.
  2. Select CSV file to upload and click Next.
  3. From new opened window download the JSON metadata schema file by clicking Download File in dropdown list at Data Schema File section.
  4. For more info on Metadata format refer to this guide: https://resources.docs.salesforce.com/200/latest/en-us/sfdc/pdf/bi_dev_guide_ext_data_format.pdf

or for an existing dataset, if you have a csv file with the dataset's data go through the same process as when creating a new dataset to get the metadata json file for it, but don't actually create the dataset.

Deleting data

To delete existing data, the MetadataFilesLocation connection property is required. You must set its value to the location of the file where your metadata files are stored.
Note: The metadata file must contain one (and only one) field with a unique identifier.
DELETE FROM Dataset_Example WHERE Col1='uniqueValue'

DELETE FROM EXISTS SELECT (Bulk deleting)

First you need to insert data into a temporary table. Temporary tables are denoted by a # appearing in their name. When using a temporary table to delete, the temporary table must be named in the format [TableName]#TEMP, where TableName is the name of the table you will be deleting from. For instance:
INSERT INTO Dataset_Example#TEMP (Col1) VALUES ('uniqueValue')
INSERT INTO Dataset_Example#TEMP (Col1) VALUES ('uniqueValue')
INSERT INTO Dataset_Example#TEMP (Col1) VALUES ('uniqueValue')
Then you need to delete from the actual table.
DELETE FROM Dataset_Example WHERE EXISTS SELECT Col1 FROM FROM Dataset_Example#TEMP
If the AsyncBulkOperation connection property is set to 'true' the provider will allow Tableau CRM to process the data while your application continues executing. The downside of using asynchronous services is that you will need to check the status of the upload manually to see if Salesforce has finished processing the request and see if there were any issues. You can do this by calling the GetJobStatus stored procedure. You can get the value of the JobId required for the GetJobStatus stored procedure from the LastResultInfo#TEMP table.
SELECT JobId FROM LastResultInfo#TEMP

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 24.0.9060