Configure Destination Database
On this page
You can configure SingleStore databases as a destination.
-
In the Destination Database dialog, select SingleStore from the Destination Database list.
-
In the SingleStore tab, enter the following configuration details:
-
Host Name: Enter the IP address or hostname of the database server.
-
Port: Enter the port number on which the database server is listening (default port for SingleStore is 3306).
-
User ID: Enter a valid SingleStore user ID to be used with Ingest.
-
Password: Enter the password for the SingleStore user.
Note: Passwords are encrypted within Ingest.
-
JDBC Options (Optional): JDBC options are optional and can be used to extend the JDBC URL for accessing the database.
-
-
Select the Advanced Options tab.
Enter the following configuration details: -
Max Updates (Default maximum update is 4): Enter a number that controls when Flow consolidates multiple changes to the same record.
When loading data, if the number of sequential changes to the same record exceeds twice this value, Flow groups the changes by primary key before applying them to the destination. Enter -1 to disable consolidation. -
Load Threads: Enter the number of parallel loading threads that Flow uses for the destination.
Increase this value to allow more concurrent load activity, depending on the capacity of your host and SingleStore deployment. -
Add Database Prefix: Enter a prefix to add to the destination schema names.
For example, if the prefix is prodand the source table ismydb:sales., the destination becomescustomers prod_.mydb_ sales. customers Leave blank to use the original schema names. -
Truncate table instead of drop: Enable this to truncate existing destination tables instead of dropping and recreating them.
Use this option when you want to reuse the destination table object while replacing its data. -
Database name and optional table name pattern: Controls how source tables are mapped to destination database and table names.
Supports placeholders: %d- source database name%s- source schema name%t- source table nameFor more information and examples, refer to Destination Naming and Multi-Tenant Support.
-
Ignore database name in schema: Enable this to exclude the source database name from destination table names.
Use this when the source database name is not needed in the destination naming convention. -
Database for staging tables: Enter a schema or database name where Flow creates staging tables during the load process.
Leave blank to create staging tables in the same location as the destination tables. -
Retain staging tables: Enable this to retain staging tables in the destination after loading completes.
Enable this option when you want to inspect staging data for troubleshooting or validation. -
Sync Struct suppressed: Enable this to prevent Flow from recreating destination tables or applying schema changes when structure mismatches are detected, or when Sync Struct operations are run.
When enabled, Flow ignores table structure differences and does not modify destination tables. This is disabled by default. For more information about Sync Struct, refer to Schema Evolution with Sync Struct.
Refer to Appendix for more information.
-
-
Select Apply to confirm and save the details.
-
Select Test to verify the connectivity.
Destination Naming and Multi-Tenant Support
The Database name and optional table name pattern field in the Advanced Options controls how source tables are written to the destination and supports multi-tenant configurations.
Important
Multi-tenant support is available for MySQL, PostgreSQL, SQL Server, and Oracle sources.
To configure multi-tenant mappings, enter a database name followed by the destination table name in the following format:
<dbname>.<destination_table_name>The destination_ can include the following symbols along with underscores.
-
%d: Source database name -
%s: Source schema name -
%t: Source table name
Note
For MySQL and Oracle sources, %d is not supported.%s to refer to the database name.
Use the following patterns to control how source objects are mapped to the destination:
-
To map all source tables into a single SingleStore database, enter a fixed database name such as
main_.db -
To map multiple source schemas into one SingleStore database, enter a fixed destination database name and include the source schema name in the destination table pattern.
For example: dest_db. %s_ %t. -
To map multiple source schemas into multiple databases, include a placeholder in the destination database name so that Flow derives the destination database dynamically from the source schema or database name.
For example: main_.%s. primary_ %t
Multi-Tenant Examples (PostgreSQL, SQL Server)
Example 1
-
Source database:
tenant1_db -
Source table:
customers -
Database name and optional table name pattern set to:
main_db. %d_ %t -
Destination database name:
main_db -
Destination table:
tenant1_db_ customers
Example 2
-
Source database:
server_db -
Source schema:
org1 -
Source table:
supplier -
Database name and optional table name pattern set to:
dest_db. %s_ %t -
Destination database name:
dest_db -
Destination table:
org1_supplier
Multi-Tenant Examples (MySQL, Oracle)
Example 1
-
Source database:
org1_db -
Source table:
customers -
Database name and optional table name pattern set to:
dest_db. %s_ %t -
Destination database name:
dest_db -
Destination table:
org1_db_ customers
Example 2
-
Source database:
vdb -
Source table:
customers -
Database name and optional table name pattern set to:
main_%s. primary_ %t -
Destination database name:
main_vdb -
Destination table:
primary_customers
Last modified: