ACC: How to Create an SQL Pass-Through Query in Code

MORE INFORMATION

You can use SPT queries to send commands directly to an ODBC database server (such as Microsoft SQL Server). Using Visual Basic (or Access Basic), you can write a function that creates an SPT query. When you run the query, it send commands directly to the ODBC database server for processing.

The following example demonstrates how to create an SPT query in code:

NOTE: In the following sample code, an underscore (_) at the end of a line is used as a line-continuation character. Remove the underscore from the end of the line when re-creating this code in Access Basic.

1. Create a module and type the following line in the Declarations section if it is not already there:

   Option Explicit

2. Type the following procedure:

         Function CreateSPT (SPTQueryName As String, SQLString As String, _
                     ConnectString As String)
         '-----------------------------------------------
         ' FUNCTION: CreateSPT()
         ' PURPOSE:
         '   Creates an SQL pass-through query using the supplied arguments:
         '      SPTQueryName: the name of the query to create
         '      SQLString: the query's SQL string
         '      ConnectString: the ODBC connect string, this must be at
         '         least "ODBC;"
         '-----------------------------------------------
            Dim mydatabase As Database, myquerydef As QueryDef
   
            Set mydatabase = DBENGINE.Workspaces(0).Databases(0)
            Set myquerydef = mydatabase.CreateQueryDef(SPTQueryName)
   
            myquerydef.connect = ConnectString
            myquerydef.sql = SQLString
            myquerydef.Close
         End Function
   						

3. To test this function, type the following line in the Debug window (or Immediate window in version 2.0), and then press ENTER:

         ? CreateSPT("MySptQuery", "sp_help", "ODBC;")

This creates the query MySptQuery and adds it to the list of queries in the Database window. When you run MySptQuery it prompts you for the ODBC connect string and runs the stored procedure sp_help, which returns a list of tables from the SQL Server.

To create an SPT query called Test that returns a list of all the records from the Authors table located on the Red server in the Pubs database, you type

   ? CreateSPT("Test", "Select * from authors",_
        "ODBC;DSN=Red;Database=Pubs;USID=JOE;PWD=JOE")
				

in the Debug window (or Immediate window in version 2.0). This example also includes the UserId and password (both "Joe") arguments in the ODBC connect string. Note that if you do not supply at least "ODBC;" as the connect string, you receive the following error message: