Data source name

In computing, a data source name (DSN, sometimes known as a database source name, though "data sources" can comprise other repositories apart from databases) is a string that has an associated data structure used to describe a connection to a data source. Most commonly used in connection with ODBC, DSNs also exist for JDBC and for other data access mechanisms. The term often overlaps with "connection string". Most systems do not make a difference between DSNs or connection strings and the term can often be used interchangeably.

DSN attributes may include, but are not limited to:

The system administrator of a client machine generally creates a separate DSN for each relevant data source.

Standardizing DSNs offers a level of indirection; various applications (for example: Apache/PHP and IIS/ASP) can take advantage of this in accessing shared data sources.

Types of data source name

Two kinds of DSN exist:

These are further broken down into

Example of use

Software (e.g., Crystal Reports, Microsoft Excel, PHP, Perl, Python, Ruby) users can submit CRUD (Create, Read, Update, Delete) queries to a data source by establishing a connection to the DSN.

ASP (VBScript) code to open a DSN connection might look like the following:

Dim DatabaseObject1
Set DatabaseObject1 = Server.CreateObject("ADODB.Connection")
DatabaseObject1.Open("DSN=DSNname;")

In PHP using the PEAR::DB package to open a connection without an external DSN (a "DSN-less connection", i.e., using a Connection String), the code might resemble the following

require_once("DB.php");
//$dsn = "<driver>://<username>:<password>@<host>:<port>/<database>";
$dsn = "mysql://john:pass@localhost:3306/my_db";
$db = DB::connect($dsn);

PHP with PDO.

$dsn = "mysql:host=localhost;dbname=example";
$dbh = new PDO($dsn, $username, $password);

In Perl, using the Perl_DBI module, each driver has its own syntax for the DSN attributes. The only requirement that DBI makes is that all the information, except for username and password is supplied in a single string argument.

my $dsn = "DBI:Pg:database=finance;host=db.example.com;port=$port";
   $dsn = "DBI:mysql:database=$database;host=$hostname;port=$port";
   $dsn = "DBI:Oracle:host=$host;sid=$sid;port=$port";
   $dsn = "DBI:SQLite:dbname=$dbfilename";

my $dbh = DBI->connect($dsn,'username','password');

See also

This article is issued from Wikipedia - version of the 7/21/2016. The text is available under the Creative Commons Attribution/Share Alike but additional terms may apply for the media files.