>

IN Clause

Description

Identifies tables in any external database to which the Microsoft Jet database engine can connect, such as a dBASE or Paradox database or an external Jet database.

Syntax

To identify a destination table:

[SELECT | INSERT] INTO destination
IN{path | ["path" "type"] | ["" [type; DATABASE = path]]}

To identify a source table:

FROM tableexpression
IN {path | ["path" "type"] | ["" [type; DATABASE = path]]}

A SELECT statement containing an IN clause has these parts.

Part Description
 
destination The name of the external table into which data is inserted.
tableexpression The name of the table or tables from which data is retrieved. This argument can be a single table name, a saved query, or a compound resulting from an INNER JOIN, LEFT JOIN, or RIGHT JOIN.
path The full path for the directory or file containing table.
type The name of the database type used to create table if a database isn't a Jet database (for example, dBASE III, dBASE IV, Paradox 3.x, Paradox 4.x, or Btrieve).

Remarks

You can use IN to connect to only one external database at a time.

In some cases, the path argument refers to the directory containing the database files. For example, when working with dBASE, FoxPro, or Paradox database tables, the path argument specifies the directory containing .dbf or .db files. The table filename is derived from the destination or tableexpression arguments.

To specify a non-Jet database, append a semicolon (;) to the name, and enclose it in single (' ') or double (" ") quotation marks. For example, either 'dBASE IV;' or "dBASE IV;" is acceptable.

You can also use the DATABASE reserved word to specify the external database. For example, the following lines specify the same table:


... FROM Table IN  "" [dBASE IV; DATABASE=C:\DBASE\DATA\SALES;];
... FROM Table IN "C:\DBASE\DATA\SALES" "dBASE IV;"
Notes

See Also

FROM Clause, INSERT INTO Statement, SELECT Statement, SELECT...INTO Statement, SQL Aggregate Functions.

Example

The following table shows how you can use the IN clause to retrieve data from an external database. In each example, assume the hypothetical Customers table is stored in an external database.

External database SQL statement
 
Microsoft Jet database.
MYDATA.mdb is the name of the Jet database that contains the Customers table.		 
SELECT CustomerID
FROM Customers
IN MYDATA.mdb 
WHERE CustomerID Like "A*";
dBASE III or IV.
To retrieve data from a dBASE III table, substitute "dBASE III" for "dBASE IV;".		 
SELECT CustomerID
FROM Customer
IN "C:\DBASE\DATA\SALES" "dBASE IV;"
WHERE CustomerID Like "A*";
dBASE III or IV using DATABASE syntax.
To retrieve data from a dBASE III table, substitute "dBASE III" for "dBASE IV;".		 
SELECT CustomerID
FROM Customer
IN "" [dBASE IV; DATABASE=C:\DBASE\DATA\SALES;] 
WHERE CustomerID Like "A*";
Paradox 3.x or 4.x.
To retrieve data from a Paradox version 3.x table, substitute "Paradox 3.x;" for "Paradox 4.x;".		 
SELECT CustomerID
FROM Customer
IN "C:\PARADOX\DATA\SALES" "Paradox 4.x;"
WHERE CustomerID Like "A*";
Paradox 3.x or 4.x using DATABASE syntax.
To retrieve data from a Paradox version 3.x table, substitute "Paradox 3.x;" for "Paradox 4.x;".		 
SELECT CustomerID
FROM Customer
IN "" [Paradox 4.x;DATABASE=C:\PARADOX\DATA\SALES;] 
WHERE CustomerID Like "A*";