Skip to content

sql-server-compact-edition-connection-manager.md

Latest commit

 

History

History
113 lines (78 loc) · 7.14 KB

sql-server-compact-edition-connection-manager.md

File metadata and controls

113 lines (78 loc) · 7.14 KB
title SQL Server Compact Edition Connection Manager
description SQL Server Compact Edition Connection Manager
author chugugrace
ms.author chugu
ms.date 03/14/2017
ms.service sql
ms.subservice integration-services
ms.topic conceptual
f1_keywords
sql13.dts.designer.sqlmobileconnection.connection.f1
sql13.dts.designer.sqlmobileconnection.all.f1
helpviewer_keywords
SQL Server Compact, connection manager
connections [Integration Services], SQL Server Compact
connection managers [Integration Services], SQL Server Compact

SQL Server Compact Edition Connection Manager

[!INCLUDEsqlserver-ssis]

A [!INCLUDEssNoVersion] Compact connection manager enables a package to connect to a [!INCLUDEssNoVersion] Compact database. The [!INCLUDEssNoVersion] Compact destination that [!INCLUDEmsCoName] [!INCLUDEssNoVersion] [!INCLUDEssISnoversion] includes uses this connection manager to load data into a table in a [!INCLUDEssNoVersion] Compact database.

Note

On a 64-bit computer, you must run packages that connect to [!INCLUDEssNoVersion] Compact data sources in 32-bit mode. The [!INCLUDEssNoVersion] Compact provider that [!INCLUDEssISnoversion] uses to connect to [!INCLUDEssNoVersion] Compact data sources is available only in a 32-bit version. SQL Server Compact Edition Connection Manager is not supported from VS2022. Details refer to Microsoft SQL Server Compact Lifecycle.

Configuration the SQL Server Compact Edition Connection Manager

When you add a [!INCLUDEssNoVersion] Compact connection manager to a package, [!INCLUDEssISnoversion] creates a connection manager that will resolve to a [!INCLUDEssNoVersion] Compact connection at run time, sets the connection manager properties, and adds the connection manager to the Connections collection on the package.

The ConnectionManagerType property of the connection manager is set to SQLMOBILE.

You can configure the [!INCLUDEssNoVersion] Compact connection manager in the following ways:

  • Provide a connection string that specifies the location of the [!INCLUDEssNoVersion] Compact database.

  • Provide a password for a password-protected database.

  • Specify the server on which the database is stored.

  • Indicate whether the connection that is created from the connection manager is retained at run time.

You can set properties through [!INCLUDEssIS] Designer or programmatically.

For information about configuring a connection manager programmatically, see xref:Microsoft.SqlServer.Dts.Runtime.ConnectionManager and Adding Connections Programmatically.

SQL Server Compact Edition Connection Manager Editor (Connection Page)

Use the SQL Server Compact Edition Connection Manager dialog box to specify properties for connecting to a [!INCLUDEssNoVersion] Compact database.

To learn more about the [!INCLUDEssNoVersion] Compact Edition connection manager, see SQL Server Compact Edition Connection Manager.

Options

Enter the database file name and path
Enter the path and filename for the [!INCLUDEssNoVersion] Compact database.

Browse
Locate the desired [!INCLUDEssNoVersion] Compact database file by using the Select SQL Server Compact Edition database dialog box.

Enter the database password
Enter the password for the [!INCLUDEssNoVersion] Compact database.

SQL Server Compact Edition Connection Manager Editor (All Page)

Use the SQL Server Compact Edition Connection Manager dialog box to specify properties for connecting to a [!INCLUDEssNoVersion] Compact database.

To learn more about the [!INCLUDEssNoVersion] Compact Edition connection manager, see SQL Server Compact Edition Connection Manager.

Options

AutoShrink Threshold
Specify the amount of free space, as a percentage, that is allowed in the [!INCLUDEssNoVersion] Compact database before the autoshrink process runs.

Default Lock Escalation
Specify the number of database locks that the [!INCLUDEssNoVersion] Compact database acquires before it tries to escalate locks.

Default Lock Timeout
Specify the default interval, in milliseconds, that a transaction will wait for a lock.

Flush Interval
Specify the interval, in seconds, between committed transactions to flush data to disk.

Locale Identifier
Specify the Locale ID (LCID) of the [!INCLUDEssNoVersion] Compact database.

Max Buffer Size
Specify the maximum amount of memory, in kilobytes, that [!INCLUDEssNoVersion] Compact uses before flushing data to disk.

Max Database Size
Specify the maximum size, in megabytes, of the [!INCLUDEssNoVersion] Compact database.

Mode
Specify the file mode in which to open the [!INCLUDEssNoVersion] Compact database. The default value for this property is Read Write.

The Mode option has four values, as described in the following table.

Value Description
Read Only Specifies read-only access to the database.
Read Write Specifies read/write permission to the database.
Exclusive Specifies exclusive access to the database.
Shared Read Specifies that other users can read from the database at the same time.

Persist Security Info
Specify whether security information is returned as part of the connection string. The default value for this option is False.

Temp File Directory
Specify the location of the [!INCLUDEssNoVersion] Compact temporary database file.

Data Source
Specify the name of the [!INCLUDEssNoVersion] Compact database.

Password
Enter the password for the [!INCLUDEssNoVersion] Compact database.