BDE - tudo sobre aliases

Top  Previous  Next

This Technical Information document will help step thru concepts regarding the creation and use of ALIASES within your Delphi Applications.

Typically, you use the BDE Configuration Utility BDECFG.EXE to create and configure aliases outside of Delphi. However, with the use of the TDatabase component, you have the ability to create and use this ALIAS within your application-- not pre-defined in the IDAPI.CFG.

 

The ability to create Aliases that are only available within your application is important. Aliases specify the location of database tables and connection parameters for database servers. Ultimately, you can gain the advantages of using ALIASES within your applications-- without having to worry about the existance of a configuration entry in the IDAPI.CFG when you deploy your application. 

 

Summary of Examples:

 

Example #1

 

Example #1 creates and configures an Alias to use STANDARD (.DB, .DBF) databases. The Alias is then used by a TTable component.

 

Example #2:

 

Example #2 creates and configures an Alias to use an INTERBASE database (.gdb). The Alias is then used by a TQuery component to join two tables of the database.

 

Example #3:

 

Example #3 creates and configures an Alias to use STANDARD (.DB, .DBF) databases. This example demonstrates how user input can be used to configure the Alias during run-time.

 

Example #1: Use of a .DB or .DBF database (STANDARD)

 

 

Create a New Project. 

Place the following components on the form: - TDatabase, TTable, TDataSource, TDBGrid, and TButton. 

Double-click on the TDatabase component or choose Database Editor from the TDatabase SpeedMenu to launch the Database Property editor. 

Set the Database Name to 'MyNewAlias'. This name will serve as your ALIAS name used in the DatabaseName Property for dataset components such as TTable, TQuery, TStoredProc. 

Select STANDARD as the Driveer Name. 

Click on the Defaults Button. This will automatically add a PATH= in the Parameter Overrides section. 

Set the PATH= to C:\DELPHI\DEMOS\DATA (PATH=C:\DELPHI\DEMOS\DATA) 

Click the OK button to close the Database Dialog. 

Set the TTable DatabaseName Property to 'MyNewAlias'

Set the TDataSource's DataSet Property to 'Table1'. 

Set the DBGrid's DataSource Property to 'DataSource1'

Place the following code inside of the TButton's OnClick event. 

    procedure TForm1.Button1Click(Sender: TObject);

    begin

          Table1.Tablename:= 'CUSTOMER';

          Table1.Active:= True;

    end;

 

Run the application. 

*** If you want an alternative way to steps 3 - 11, place the following code inside of the TButton's OnClick event. 

 

    procedure TForm1.Button1Click(Sender: TObject);

    begin

          Database1.DatabaseName:= 'MyNewAlias';

          Database1.DriverName:= 'STANDARD';

          Database1.Params.Clear;

          Database1.Params.Add('PATH=C:\DELPHI\DEMOS\DATA');

          Table1.DatabaseName:= 'MyNewAlias';

          Table1.TableName:= 'CUSTOMER';

          Table1.Active:= True;

          DataSource1.DataSet:= Table1;

          DBGrid1.DataSource:= DataSource1;

    end;

 

Example #2: Use of a INTERBASE database

 

Create a New Project. 

Place the following components on the form: - TDatabase, TQuery, TDataSource, TDBGrid, and TButton. 

Double-click on the TDatabase component or choose Database Editor from the TDatabase SpeedMenu to launch the Database Property editor. 

Set the Database Name to 'MyNewAlias'. This name will serve as your ALIAS name used in the DatabaseName Property for dataset components such as TTable, TQuery, TStoredProc. 

Select INTRBASE as the Driver Name. 

Click on the Defaults Button. This will automatically add the following entries in the Parameter Overrides section. 

 SERVER NAME=IB_SERVEER:/PATH/DATABASE.GDB

 USER NAME=MYNAME

 OPEN MODE=READ/WRITE

 SCHEMA CACHE SIZE=8

 LANGDRIVER=

 SQLQRYMODE=

 SQLPASSTHRU MODE=NOT SHARED

 SCHEMA CACHE TIME=-1

 PASSWORD=

 

Set the following parameters 

 SERVER NAME=C:\IBLOCAL\EXAMPLES\EMPLOYEE.GDB

 USER NAME=SYSDBA

 OPEN MODE=READ/WRITE

 SCHEMA CACHE SIZE=8

 LANGDRIVER=

 SQLQRYMODE=

 SQLPASSTHRU MODE=NOT SHARED

 SCHEMA CACHE TIME=-1

 PASSWORD=masterkey

 

Set the TDatabase LoginPrompt Property to 'False'If you supply the PASSWORD in the Parameter Overrides section and set the LoginPrompt to 'False', you will not be prompted for the password when connecting to the database. WARNING: If an incorrect password in entered in the Parameter Overrides section and LoginPrompt is set to 'False', you are not prompted by the Password dialog to re-enter a valid password

Click the OK button to close the Database Dialog. 

Set the TQuery DatabaseName Property to 'MyNewAliias'

Set the TDataSource's DataSet Property to 'Query1'. 

Set the DBGrid's DataSource Property to 'DataSource1'

Place the following code inside of the TButton's OnClick event. 

    procedure TForm1.Button1Click(Sender: TObject);

    begin

          Query1.SQL.Clear;

          Query1.SQL.ADD(

         'SELECT DISTINCT * FROM CUSTOMER C, SALES S

         WHERE (S.CUST_NO = C.CUST_NO)

         ORDER BY C.CUST_NO, C.CUSTOMER');

          Query1.Active:= True;

    end;

 

Run the application. 

Example #3: User-defined Alias Configuration

This example brings up a input dialog and prompts the user to enter the directory to which the ALIAS is to be configured to. 

 

The directory, servername, path, database name, and other neccessary Alias parameters can be read into the application from use of an input dialog or .INI file.

 

 

Follow the steps (1-11) in Example #1. 

Place the following code inside of the TButton's OnClick event. 

procedure TForm1.Buttton1Click(Sender: TObject);

var

  NewString: string;

  ClickedOK: Boolean;

begin

  NewString := 'C:\';

  ClickedOK := InputQuery('Database Path'

 'Path: --> C:\DELPHI\DEMOS\DATA', NewString);

  if ClickedOK then

  begin

    Database1.DatabaseName:= 'MyNewAlias';

    Database1.DriverName:= 'STANDARD';

    Database1.Params.Clear;

    Database1.Params.Add('Path=' + NewString);

     Table1.DatabaseName:= 'MyNewAlias';

    Table1.TableName:= 'CUSTOMER';

    Table1.Active:= True;

    DataSource1.DataSet:= Table1;

    DBGrid1.DataSource:= DataSource1;

  end;

end;

 

Run the Application.