download/file.php

{*********************************************************}

{                                                         }

{                 Zeos Database Objects                   }

{           Abstract Database Connectivity Classes        }

{                                                         }

{        Originally written by Sergey Seroukhov           }

{                                                         }

{*********************************************************}


{@********************************************************}

{    Copyright (c) 1999-2012 Zeos Development Group       }

{                                                         }

{ License Agreement:                                      }

{                                                         }

{ This library is distributed in the hope that it will be }

{ useful, but WITHOUT ANY WARRANTY; without even the      }

{ implied warranty of MERCHANTABILITY or FITNESS FOR      }

{ A PARTICULAR PURPOSE.  See the GNU Lesser General       }

{ Public License for more details.                        }

{                                                         }

{ The source code of the ZEOS Libraries and packages are  }

{ distributed under the Library GNU General Public        }

{ License (see the file COPYING / COPYING.ZEOS)           }

{ with the following  modification:                       }

{ As a special exception, the copyright holders of this   }

{ library give you permission to link this library with   }

{ independent modules to produce an executable,           }

{ regardless of the license terms of these independent    }

{ modules, and to copy and distribute the resulting       }

{ executable under terms of your choice, provided that    }

{ you also meet, for each linked independent module,      }

{ the terms and conditions of the license of that module. }

{ An independent module is a module which is not derived  }

{ from or based on this library. If you modify this       }

{ library, you may extend this exception to your version  }

{ of the library, but you are not obligated to do so.     }

{ If you do not wish to do so, delete this exception      }

{ statement from your version.                            }

{                                                         }

{                                                         }

{ The project web site is located on:                     }

{   http://zeos.firmos.at  (FORUM)                        }

{   http://sourceforge.net/p/zeoslib/tickets/ (BUGTRACKER)}

{   svn://svn.code.sf.net/p/zeoslib/code-0/trunk (SVN)    }

{                                                         }

{   http://www.sourceforge.net/projects/zeoslib.          }

{                                                         }

{                                                         }

{                                 Zeos Development Group. }

{********************************************************@}


unit ZDbcMetadata;


interface


{$I ZDbc.inc}


uses

{$IFDEF FPC}

  {$IFDEF WIN32}

    Comobj,

  {$ENDIF}

{$ENDIF}

  Types, Classes, {$IFDEF MSEgui}mclasses,{$ENDIF} SysUtils, Contnrs,

  ZSysUtils, ZClasses, ZDbcIntfs, ZDbcResultSetMetadata, ZDbcCachedResultSet,

  ZDbcCache, ZCompatibility, ZSelectSchema, ZURL, ZDbcConnection;


const

  procedureColumnUnknown = 0;

  procedureColumnIn = 1;

  procedureColumnInOut = 2;

  procedureColumnOut = 4;

  procedureColumnReturn = 5;

  procedureColumnResult = 3;

  procedureNoNulls = 0;

  procedureNullable = 1;

  procedureNullableUnknown = 2;


type

  TZWildcardsSet= {$IFDEF UNICODE}TSysCharSet{$ELSE}set of Char{$ENDIF};


  {** Defines a metadata resultset column definition. }

  TZMetadataColumnDef = {$ifndef FPC_REQUIRES_PROPER_ALIGNMENT}packed{$endif} record

    Name: string;

    SQLType: TZSQLType;

    Length: Integer

  end;


  {** Defines a dynamic array of metadata column definitions. }

  TZMetadataColumnDefs = array of TZMetadataColumnDef;


  {** Represents a Virtual ResultSet interface. }

  IZVirtualResultSet = interface(IZCachedResultSet)

    ['{D84055AC-BCD5-40CD-B408-6F11AF000C96}']

    procedure SetType(Value: TZResultSetType);

    procedure SetConcurrency(Value: TZResultSetConcurrency);

  end;


  {** Implements Virtual ResultSet. }

  TZVirtualResultSet = class(TZAbstractCachedResultSet, IZVirtualResultSet)

  protected

    procedure CalculateRowDefaults(RowAccessor: TZRowAccessor); override;

    procedure PostRowUpdates(OldRowAccessor, NewRowAccessor: TZRowAccessor);

      override;

  public

    constructor CreateWithStatement(const SQL: string; Statement: IZStatement;

      ConSettings: PZConSettings);

    constructor CreateWithColumns(ColumnsInfo: TObjectList; const SQL: string;

      ConSettings: PZConSettings);

    destructor Destroy; override;

  end;


  {** Implements Abstract Database Metadata. }


  { TZAbstractDatabaseMetadata }


  TZAbstractDatabaseMetadata = class(TContainedObject, IZDatabaseMetadata)

  private

    FConnection: Pointer;

    FUrl: TZURL;

    FCachedResultSets: IZHashMap;

    FDatabaseInfo: IZDatabaseInfo;

    FConSettings: PZConSettings;

    FIC: IZIdentifierConvertor;

    function GetInfo: TStrings;

    function GetURLString: String;

    function StripEscape(const Pattern: string): string;

    function HasNoWildcards(const Pattern: string): boolean;

  protected

    FDatabase: String;

    WildcardsArray: array of char; //Added by Cipto

    function EscapeString(const S: string): string; virtual;

    function DecomposeObjectString(const S: String): String; virtual;

    function CreateDatabaseInfo: IZDatabaseInfo; virtual; // technobot 2008-06-24

    function GetStatement: IZSTatement; // technobot 2008-06-28 - moved from descendants


    { Metadata ResultSets Caching. }

    procedure AddResultSetToCache(const Key: string; ResultSet: IZResultSet);

    function GetResultSetFromCache(const Key: string): IZResultSet;

    function ConstructVirtualResultSet(ColumnsDefs: TZMetadataColumnDefs):

      IZVirtualResultSet;

    function CopyToVirtualResultSet(SrcResultSet: IZResultSet;

      DestResultSet: IZVirtualResultSet): IZVirtualResultSet;

    function CloneCachedResultSet(ResultSet: IZResultSet): IZResultSet;

    function ConstructNameCondition(Pattern: string; Column: string): string; virtual;

    function AddEscapeCharToWildcards(const Pattern:string): string;

    function GetWildcardsSet:TZWildcardsSet;

    procedure FillWildcards; virtual;

    function NormalizePatternCase(Pattern:String): string;

    property Url: string read GetURLString;

    property Info: TStrings read GetInfo;

    property CachedResultSets: IZHashMap read FCachedResultSets

      write FCachedResultSets;

    property ConSettings: PZConSettings read FConSettings write FConSettings;

    property IC: IZIdentifierConvertor read FIC;

  protected

    function UncachedGetTables(const Catalog: string; const SchemaPattern: string;

      const TableNamePattern: string; const Types: TStringDynArray): IZResultSet; virtual;

    function UncachedGetSchemas: IZResultSet; virtual;

    function UncachedGetCatalogs: IZResultSet; virtual;

    function UncachedGetTableTypes: IZResultSet; virtual;

    function UncachedGetColumns(const Catalog: string; const SchemaPattern: string;

      const TableNamePattern: string; const ColumnNamePattern: string): IZResultSet; virtual;

    function UncachedGetTablePrivileges(const Catalog: string; const SchemaPattern: string;

      const TableNamePattern: string): IZResultSet; virtual;

    function UncachedGetColumnPrivileges(const Catalog: string; const Schema: string;

      const Table: string; const ColumnNamePattern: string): IZResultSet; virtual;


    function UncachedGetPrimaryKeys(const Catalog: string; const Schema: string;

      const Table: string): IZResultSet; virtual;

    function UncachedGetImportedKeys(const Catalog: string; const Schema: string;

      const Table: string): IZResultSet; virtual;

    function UncachedGetExportedKeys(const Catalog: string; const Schema: string;

      const Table: string): IZResultSet; virtual;

    function UncachedGetCrossReference(const PrimaryCatalog: string; const PrimarySchema: string;

      const PrimaryTable: string; const ForeignCatalog: string; const ForeignSchema: string;

      const ForeignTable: string): IZResultSet; virtual;

    function UncachedGetIndexInfo(const Catalog: string; const Schema: string; const Table: string;

      Unique: Boolean; Approximate: Boolean): IZResultSet; virtual;

    function UncachedGetSequences(const Catalog: string; const SchemaPattern: string;

      const SequenceNamePattern: string): IZResultSet; virtual;

    function UncachedGetTriggers(const Catalog: string; const SchemaPattern: string;

      const TableNamePattern: string; const TriggerNamePattern: string): IZResultSet; virtual; //EgonHugeist

    function UncachedGetCollationAndCharSet(const Catalog, SchemaPattern,

      TableNamePattern, ColumnNamePattern: string): IZResultSet; virtual; //EgonHugeist

    function UncachedGetCharacterSets: IZResultSet; virtual; //EgonHugeist

    function UncachedGetProcedures(const Catalog: string; const SchemaPattern: string;

      const ProcedureNamePattern: string): IZResultSet; virtual;

    function UncachedGetProcedureColumns(const Catalog: string; const SchemaPattern: string;

      const ProcedureNamePattern: string; const ColumnNamePattern: string):

      IZResultSet; virtual;

    function UncachedGetBestRowIdentifier(const Catalog: string; const Schema: string;

      const Table: string; Scope: Integer; Nullable: Boolean): IZResultSet; virtual;

    function UncachedGetVersionColumns(const Catalog: string; const Schema: string;

      const Table: string): IZResultSet; virtual;

    function UncachedGetTypeInfo: IZResultSet; virtual;

    function UncachedGetUDTs(const Catalog: string; const SchemaPattern: string;

      const TypeNamePattern: string; const Types: TIntegerDynArray): IZResultSet; virtual;

  public

    constructor Create(Connection: TZAbstractConnection; const Url: TZURL); virtual;

    destructor Destroy; override;


    function GetURL: string; virtual;

    function GetUserName: string; virtual;


    function GetDatabaseInfo: IZDatabaseInfo; // technobot 2008-06-24 - see also CreateDatabaseInfo method.


    function GetTables(const Catalog: string; const SchemaPattern: string;

      const TableNamePattern: string; const Types: TStringDynArray): IZResultSet;

    function GetSchemas: IZResultSet;

    function GetCatalogs: IZResultSet;

    function GetTableTypes: IZResultSet;

    function GetColumns(const Catalog: string; const SchemaPattern: string;

      const TableNamePattern: string; const ColumnNamePattern: string): IZResultSet;

    function GetTablePrivileges(const Catalog: string; const SchemaPattern: string;

      const TableNamePattern: string): IZResultSet;

    function GetColumnPrivileges(const Catalog: string; const Schema: string;

      const Table: string; const ColumnNamePattern: string): IZResultSet;

    function GetPrimaryKeys(const Catalog: string; const Schema: string;

      const Table: string): IZResultSet;

    function GetImportedKeys(const Catalog: string; const Schema: string;

      const Table: string): IZResultSet;

    function GetExportedKeys(const Catalog: string; const Schema: string;

      const Table: string): IZResultSet;

    function GetCrossReference(const PrimaryCatalog: string; const PrimarySchema: string;

      const PrimaryTable: string; const ForeignCatalog: string; const ForeignSchema: string;

      const ForeignTable: string): IZResultSet;

    function GetIndexInfo(const Catalog: string; const Schema: string; const Table: string;

      Unique: Boolean; Approximate: Boolean): IZResultSet;

    function GetCollationAndCharSet(const Catalog, Schema, TableName, ColumnName: String): IZResultSet; //EgonHugeist

    function GetCharacterSets: IZResultSet; //EgonHugeist

    function GetTriggers(const Catalog: string; const SchemaPattern: string;

      const TableNamePattern: string; const TriggerNamePattern: string): IZResultSet; //EgonHugesit

    function GetSequences(const Catalog: string; const SchemaPattern: string;

      const SequenceNamePattern: string): IZResultSet;

    function GetProcedures(const Catalog: string; const SchemaPattern: string;

      const ProcedureNamePattern: string): IZResultSet;

    function GetProcedureColumns(const Catalog: string; const SchemaPattern: string;

      const ProcedureNamePattern: string; const ColumnNamePattern: string):

      IZResultSet;

    function GetBestRowIdentifier(const Catalog: string; const Schema: string;

      const Table: string; Scope: Integer; Nullable: Boolean): IZResultSet;

    function GetVersionColumns(const Catalog: string; const Schema: string;

      const Table: string): IZResultSet;

    function GetTypeInfo: IZResultSet;

    function GetUDTs(const Catalog: string; const SchemaPattern: string;

      const TypeNamePattern: string; const Types: TIntegerDynArray): IZResultSet;


    function GetConnection: IZConnection; virtual;


    function GetIdentifierConvertor: IZIdentifierConvertor; virtual;

    procedure ClearCache; overload;virtual;

    procedure ClearCache(const Key: string);overload;virtual;


    // --> technobot 2008-06-14:  metadata cache key retrieval API:

    function GetTablesCacheKey(const Catalog: string; const SchemaPattern: string;

      const TableNamePattern: string; const Types: TStringDynArray): string;

    function GetSchemasCacheKey: string;

    function GetCatalogsCacheKey: string;

    function GetTableTypesCacheKey: string;

    function GetColumnsCacheKey(const Catalog: string; const SchemaPattern: string;

      const TableNamePattern: string; const ColumnNamePattern: string): string;

    function GetColumnPrivilegesCacheKey(const Catalog: string; const Schema: string;

      const Table: string; const ColumnNamePattern: string): string;

    function GetTablePrivilegesCacheKey(const Catalog: string; const SchemaPattern: string;

      const TableNamePattern: string): string;

    function GetPrimaryKeysCacheKey(const Catalog: string; const Schema: string;

      const Table: string): string;

    function GetImportedKeysCacheKey(const Catalog: string; const Schema: string;

      const Table: string): string;

    function GetExportedKeysCacheKey(const Catalog: string; const Schema: string;

      const Table: string): string;

    function GetCrossReferenceCacheKey(const PrimaryCatalog: string; const PrimarySchema: string;

      const PrimaryTable: string; const ForeignCatalog: string; const ForeignSchema: string;

      const ForeignTable: string): string;

    function GetIndexInfoCacheKey(const Catalog: string; const Schema: string; const Table: string;

      const Unique: Boolean; const Approximate: Boolean): string;

    function GetSequencesCacheKey(const Catalog: string; const SchemaPattern: string;

      const SequenceNamePattern: string): string;

    function GetCollationAndCharSetCacheKey(const Catalog, SchemaPattern,

      TableNamePattern, ColumnPattern: String): string; //EgonHugeist

    function GetCharacterSetsCacheKey: String; //EgonHugeist

    function GetTriggersCacheKey(const Catalog: string;

      const SchemaPattern: string; const TableNamePattern: string;

      const TriggerNamePattern: string): string; //EgonHugeist

    function GetProceduresCacheKey(const Catalog: string; const SchemaPattern: string;

      const ProcedureNamePattern: string): string;

    function GetProcedureColumnsCacheKey(const Catalog: string; const SchemaPattern: string;

      const ProcedureNamePattern: string; const ColumnNamePattern: string): string;

    function GetBestRowIdentifierCacheKey(const Catalog: string; const Schema: string;

      const Table: string; const Scope: Integer; const Nullable: Boolean): string;

    function GetVersionColumnsCacheKey(const Catalog: string; const Schema: string;

      const Table: string): string;

    function GetTypeInfoCacheKey: string;

    function GetUDTsCacheKey(const Catalog: string; const SchemaPattern: string;

      const TypeNamePattern: string; const Types: TIntegerDynArray): string;


    procedure GetCacheKeys(List: TStrings);

    // <-- technobot 2008-06-14

  end;


  // technobot 2008-06-24 - methods moved as is from TZAbstractDatabaseMetadata:

  {** Implements Abstract Database Information. }

  TZAbstractDatabaseInfo = class(TInterfacedObject, IZDatabaseInfo)

  private

    FMetadata: TZAbstractDatabaseMetadata;

  protected

    FIdentifierQuotes: String;

    property Metadata: TZAbstractDatabaseMetadata read FMetadata;

  public

    constructor Create(const Metadata: TZAbstractDatabaseMetadata); overload;

    constructor Create(const Metadata: TZAbstractDatabaseMetadata;

      const IdentifierQuotes: String); overload;

    destructor Destroy; override;


    // database/driver/server info:

    function GetDatabaseProductName: string; virtual;

    function GetDatabaseProductVersion: string; virtual;

    function GetDriverName: string; virtual;

    function GetDriverVersion: string; virtual;

    function GetDriverMajorVersion: Integer; virtual;

    function GetDriverMinorVersion: Integer; virtual;

    function GetServerVersion: string; virtual;


    // capabilities (what it can/cannot do):

    function AllProceduresAreCallable: Boolean; virtual;

    function AllTablesAreSelectable: Boolean; virtual;

    function SupportsMixedCaseIdentifiers: Boolean; virtual;

    function SupportsMixedCaseQuotedIdentifiers: Boolean; virtual;

    function SupportsAlterTableWithAddColumn: Boolean; virtual;

    function SupportsAlterTableWithDropColumn: Boolean; virtual;

    function SupportsColumnAliasing: Boolean; virtual;

    function SupportsConvert: Boolean; virtual;

    function SupportsConvertForTypes(FromType: TZSQLType; ToType: TZSQLType):

      Boolean; virtual;

    function SupportsTableCorrelationNames: Boolean; virtual;

    function SupportsDifferentTableCorrelationNames: Boolean; virtual;

    function SupportsExpressionsInOrderBy: Boolean; virtual;

    function SupportsOrderByUnrelated: Boolean; virtual;

    function SupportsGroupBy: Boolean; virtual;

    function SupportsGroupByUnrelated: Boolean; virtual;

    function SupportsGroupByBeyondSelect: Boolean; virtual;

    function SupportsLikeEscapeClause: Boolean; virtual;

    function SupportsMultipleResultSets: Boolean; virtual;

    function SupportsMultipleTransactions: Boolean; virtual;

    function SupportsNonNullableColumns: Boolean; virtual;

    function SupportsMinimumSQLGrammar: Boolean; virtual;

    function SupportsCoreSQLGrammar: Boolean; virtual;

    function SupportsExtendedSQLGrammar: Boolean; virtual;

    function SupportsANSI92EntryLevelSQL: Boolean; virtual;

    function SupportsANSI92IntermediateSQL: Boolean; virtual;

    function SupportsANSI92FullSQL: Boolean; virtual;

    function SupportsIntegrityEnhancementFacility: Boolean; virtual;

    function SupportsOuterJoins: Boolean; virtual;

    function SupportsFullOuterJoins: Boolean; virtual;

    function SupportsLimitedOuterJoins: Boolean; virtual;

    function SupportsSchemasInDataManipulation: Boolean; virtual;

    function SupportsSchemasInProcedureCalls: Boolean; virtual;

    function SupportsSchemasInTableDefinitions: Boolean; virtual;

    function SupportsSchemasInIndexDefinitions: Boolean; virtual;

    function SupportsSchemasInPrivilegeDefinitions: Boolean; virtual;

    function SupportsCatalogsInDataManipulation: Boolean; virtual;

    function SupportsCatalogsInProcedureCalls: Boolean; virtual;

    function SupportsCatalogsInTableDefinitions: Boolean; virtual;

    function SupportsCatalogsInIndexDefinitions: Boolean; virtual;

    function SupportsCatalogsInPrivilegeDefinitions: Boolean; virtual;

    function SupportsOverloadPrefixInStoredProcedureName: Boolean; virtual;

    function SupportsPositionedDelete: Boolean; virtual;

    function SupportsPositionedUpdate: Boolean; virtual;

    function SupportsSelectForUpdate: Boolean; virtual;

    function SupportsStoredProcedures: Boolean; virtual;

    function SupportsSubqueriesInComparisons: Boolean; virtual;

    function SupportsSubqueriesInExists: Boolean; virtual;

    function SupportsSubqueriesInIns: Boolean; virtual;

    function SupportsSubqueriesInQuantifieds: Boolean; virtual;

    function SupportsCorrelatedSubqueries: Boolean; virtual;

    function SupportsUnion: Boolean; virtual;

    function SupportsUnionAll: Boolean; virtual;

    function SupportsOpenCursorsAcrossCommit: Boolean; virtual;

    function SupportsOpenCursorsAcrossRollback: Boolean; virtual;

    function SupportsOpenStatementsAcrossCommit: Boolean; virtual;

    function SupportsOpenStatementsAcrossRollback: Boolean; virtual;

    function SupportsTransactions: Boolean; virtual;

    function SupportsTransactionIsolationLevel(Level: TZTransactIsolationLevel):

      Boolean; virtual;

    function SupportsDataDefinitionAndDataManipulationTransactions: Boolean; virtual;

    function SupportsDataManipulationTransactionsOnly: Boolean; virtual;

    function SupportsResultSetType(_Type: TZResultSetType): Boolean; virtual;

    function SupportsResultSetConcurrency(_Type: TZResultSetType;

      Concurrency: TZResultSetConcurrency): Boolean; virtual;

    function SupportsBatchUpdates: Boolean; virtual;

    function SupportsNonEscapedSearchStrings: Boolean; virtual;

    function SupportsUpdateAutoIncrementFields: Boolean; virtual;


    // maxima:

    function GetMaxBinaryLiteralLength: Integer; virtual;

    function GetMaxCharLiteralLength: Integer; virtual;

    function GetMaxColumnNameLength: Integer; virtual;

    function GetMaxColumnsInGroupBy: Integer; virtual;

    function GetMaxColumnsInIndex: Integer; virtual;

    function GetMaxColumnsInOrderBy: Integer; virtual;

    function GetMaxColumnsInSelect: Integer; virtual;

    function GetMaxColumnsInTable: Integer; virtual;

    function GetMaxConnections: Integer; virtual;

    function GetMaxCursorNameLength: Integer; virtual;

    function GetMaxIndexLength: Integer; virtual;

    function GetMaxSchemaNameLength: Integer; virtual;

    function GetMaxProcedureNameLength: Integer; virtual;

    function GetMaxCatalogNameLength: Integer; virtual;

    function GetMaxRowSize: Integer; virtual;

    function GetMaxStatementLength: Integer; virtual;

    function GetMaxStatements: Integer; virtual;

    function GetMaxTableNameLength: Integer; virtual;

    function GetMaxTablesInSelect: Integer; virtual;

    function GetMaxUserNameLength: Integer; virtual;


    // policies (how are various data and operations handled):

    function IsReadOnly: Boolean; virtual;

    function IsCatalogAtStart: Boolean; virtual;

    function DoesMaxRowSizeIncludeBlobs: Boolean; virtual;

    function NullsAreSortedHigh: Boolean; virtual;

    function NullsAreSortedLow: Boolean; virtual;

    function NullsAreSortedAtStart: Boolean; virtual;

    function NullsAreSortedAtEnd: Boolean; virtual;

    function NullPlusNonNullIsNull: Boolean; virtual;

    function UsesLocalFiles: Boolean; virtual;

    function UsesLocalFilePerTable: Boolean; virtual;

    function StoresUpperCaseIdentifiers: Boolean; virtual;

    function StoresLowerCaseIdentifiers: Boolean; virtual;

    function StoresMixedCaseIdentifiers: Boolean; virtual;

    function StoresUpperCaseQuotedIdentifiers: Boolean; virtual;

    function StoresLowerCaseQuotedIdentifiers: Boolean; virtual;

    function StoresMixedCaseQuotedIdentifiers: Boolean; virtual;

    function GetDefaultTransactionIsolation: TZTransactIsolationLevel; virtual;

    function DataDefinitionCausesTransactionCommit: Boolean; virtual;

    function DataDefinitionIgnoredInTransactions: Boolean; virtual;


    // interface details (terms, keywords, etc):

    function GetIdentifierQuoteString: string;

    function GetSchemaTerm: string; virtual;

    function GetProcedureTerm: string; virtual;

    function GetCatalogTerm: string; virtual;

    function GetCatalogSeparator: string; virtual;

    function GetSQLKeywords: string; virtual;

    function GetNumericFunctions: string; virtual;

    function GetStringFunctions: string; virtual;

    function GetSystemFunctions: string; virtual;

    function GetTimeDateFunctions: string; virtual;

    function GetSearchStringEscape: string; virtual;

    function GetExtraNameCharacters: string; virtual;

  end;


  {** Implements a default Case Sensitive/Unsensitive identifier convertor. }

  TZDefaultIdentifierConvertor = class (TZAbstractObject,

    IZIdentifierConvertor)

  private

    FMetadata: Pointer;

    function GetMetaData: IZDatabaseMetadata;

  protected

    property Metadata: IZDatabaseMetadata read GetMetaData;


    function IsLowerCase(const Value: string): Boolean;

    function IsUpperCase(const Value: string): Boolean;

    function IsSpecialCase(const Value: string): Boolean; virtual;

  public

    constructor Create(Metadata: IZDatabaseMetadata);


    function IsCaseSensitive(const Value: string): Boolean;

    function IsQuoted(const Value: string): Boolean; virtual;

    function Quote(const Value: string): string; virtual;

    function ExtractQuote(const Value: string): string; virtual;

  end;


  function GetTablesMetaDataCacheKey(Const Catalog:String;

      Const SchemaPattern:String;Const TableNamePattern:String;const Types: TStringDynArray):String;

      deprecated; // (technobot) use TZAbstractDatabaseMetadata.GetTablesCacheKey instead


var

  CharacterSetsColumnsDynArray: TZMetadataColumnDefs; //EgonHugeist

  CollationCharSetColumnsDynArray: TZMetadataColumnDefs; //EgonHugeist

  TriggersColumnsDynArray: TZMetadataColumnDefs; //EgonHugeist

  TriggersColColumnsDynArray: TZMetadataColumnDefs;

  ProceduresColumnsDynArray: TZMetadataColumnDefs;

  ProceduresColColumnsDynArray: TZMetadataColumnDefs;

  TableColumnsDynArray: TZMetadataColumnDefs;

  SchemaColumnsDynArray: TZMetadataColumnDefs;

  CatalogColumnsDynArray: TZMetadataColumnDefs;

  TableTypeColumnsDynArray: TZMetadataColumnDefs;

  TableColColumnsDynArray: TZMetadataColumnDefs;

  TableColPrivColumnsDynArray: TZMetadataColumnDefs;

  TablePrivColumnsDynArray: TZMetadataColumnDefs;

  BestRowIdentColumnsDynArray: TZMetadataColumnDefs;

  TableColVerColumnsDynArray: TZMetadataColumnDefs;

  PrimaryKeyColumnsDynArray: TZMetadataColumnDefs;

  ImportedKeyColumnsDynArray: TZMetadataColumnDefs;

  ExportedKeyColumnsDynArray: TZMetadataColumnDefs;

  CrossRefColumnsDynArray: TZMetadataColumnDefs;

  TypeInfoColumnsDynArray: TZMetadataColumnDefs;

  IndexInfoColumnsDynArray: TZMetadataColumnDefs;

  SequenceColumnsDynArray: TZMetadataColumnDefs;

  UDTColumnsDynArray: TZMetadataColumnDefs;


implementation


uses ZVariant, ZCollections, ZMessages;


{ TZAbstractDatabaseInfo }


{**

  Constructs this object.

  @param Metadata the interface of the correpsonding database metadata object

}

constructor TZAbstractDatabaseInfo.Create(const Metadata: TZAbstractDatabaseMetadata);

begin

  Create(MetaData, '"');

end;


{**

  Constructs this object.

  @param Metadata the interface of the correpsonding database metadata object

  @param IdentifierQuotes

    What's the string used to quote SQL identifiers?

    This returns a space " " if identifier quoting isn't supported.

    A JDBC Compliant<sup><font size=-2>TM</font></sup>

    driver always uses a double quote character.

}

constructor TZAbstractDatabaseInfo.Create(const Metadata: TZAbstractDatabaseMetadata;

  const IdentifierQuotes: String);

begin

  inherited Create;

  FMetadata := Metadata;

  if FMetaData.FUrl.Properties.IndexOfName('identifier_quotes') > -1 then //prevent to loose emty quotes '' !!!

    FIdentifierQuotes := FMetaData.FUrl.Properties.Values['identifier_quotes']

  else

    if IdentifierQuotes = '' then

      FIdentifierQuotes := '"'

    else

      FIdentifierQuotes := IdentifierQuotes;

end;


{**

  Destroys this object and cleanups the memory.

}

destructor TZAbstractDatabaseInfo.Destroy;

begin

  FMetadata := nil;

  inherited;

end;


//----------------------------------------------------------------------

// First, a variety of minor information about the target database.


{**

  Can all the procedures returned by getProcedures be called by the

  current user?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.AllProceduresAreCallable: Boolean;

begin

  Result := True;

end;


{**

  Can all the tables returned by getTable be SELECTed by the

  current user?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.AllTablesAreSelectable: Boolean;

begin

  Result := True;

end;


{**

  Is the database in read-only mode?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.IsReadOnly: Boolean;

begin

  Result := False;

end;


{**

  Are NULL values sorted high?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.NullsAreSortedHigh: Boolean;

begin

  Result := False;

end;


{**

  Are NULL values sorted low?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.NullsAreSortedLow: Boolean;

begin

  Result := False;

end;


{**

  Are NULL values sorted at the start regardless of sort order?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.NullsAreSortedAtStart: Boolean;

begin

  Result := False;

end;


{**

  Are NULL values sorted at the end regardless of sort order?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.NullsAreSortedAtEnd: Boolean;

begin

  Result := False;

end;


{**

  What's the name of this database product?

  @return database product name

}

function TZAbstractDatabaseInfo.GetDatabaseProductName: string;

begin

  Result := '';

end;


{**

  What's the version of this database product?

  @return database version

}

function TZAbstractDatabaseInfo.GetDatabaseProductVersion: string;

begin

  Result := '';

end;


{**

  What's the name of this JDBC driver?

  @return JDBC driver name

}

function TZAbstractDatabaseInfo.GetDriverName: string;

begin

  Result := 'Zeos Database Connectivity Driver';

end;


{**

  What's the version of this JDBC driver?

  @return JDBC driver version

}

function TZAbstractDatabaseInfo.GetDriverVersion: string;

begin

  Result := Format('%d.%d', [GetDriverMajorVersion, GetDriverMinorVersion]);

end;


{**

  What's this JDBC driver's major version number?

  @return JDBC driver major version

}

function TZAbstractDatabaseInfo.GetDriverMajorVersion: Integer;

begin

  Result := 1;

end;


{**

  What's this JDBC driver's minor version number?

  @return JDBC driver minor version number

}

function TZAbstractDatabaseInfo.GetDriverMinorVersion: Integer;

begin

  Result := 0;

end;


{**

  Returns the server version

  @return the server version string

}

function TZAbstractDatabaseInfo.GetServerVersion: string;

begin

  Result := '';

end;


{**

  Does the database store tables in a local file?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.UsesLocalFiles: Boolean;

begin

  Result := True;

end;


{**

  Does the database use a file for each table?

  @return true if the database uses a local file for each table

}

function TZAbstractDatabaseInfo.UsesLocalFilePerTable: Boolean;

begin

  Result := False;

end;


{**

  Does the database treat mixed case unquoted SQL identifiers as

  case sensitive and as a result store them in mixed case?

  A JDBC Compliant<sup><font size=-2>TM</font></sup> driver will always return false.

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsMixedCaseIdentifiers: Boolean;

begin

  Result := False;

end;


{**

  Does the database treat mixed case unquoted SQL identifiers as

  case insensitive and store them in upper case?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.StoresUpperCaseIdentifiers: Boolean;

begin

  Result := False;

end;


{**

  Does the database treat mixed case unquoted SQL identifiers as

  case insensitive and store them in lower case?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.StoresLowerCaseIdentifiers: Boolean;

begin

  Result := False;

end;


{**

  Does the database treat mixed case unquoted SQL identifiers as

  case insensitive and store them in mixed case?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.StoresMixedCaseIdentifiers: Boolean;

begin

  Result := True;

end;


{**

  Does the database treat mixed case quoted SQL identifiers as

  case sensitive and as a result store them in mixed case?

  A JDBC Compliant<sup><font size=-2>TM</font></sup> driver will always return true.

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsMixedCaseQuotedIdentifiers: Boolean;

begin

  Result := True;

end;


{**

  Does the database treat mixed case quoted SQL identifiers as

  case insensitive and store them in upper case?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.StoresUpperCaseQuotedIdentifiers: Boolean;

begin

  Result := False;

end;


{**

  Does the database treat mixed case quoted SQL identifiers as

  case insensitive and store them in lower case?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.StoresLowerCaseQuotedIdentifiers: Boolean;

begin

  Result := False;

end;


{**

  Does the database treat mixed case quoted SQL identifiers as

  case insensitive and store them in mixed case?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.StoresMixedCaseQuotedIdentifiers: Boolean;

begin

  Result := False;

end;


{**

  What's the string used to quote SQL identifiers?

  This returns a space " " if identifier quoting isn't supported.

  A JDBC Compliant<sup><font size=-2>TM</font></sup>

  driver always uses a double quote character.

  @return the quoting string

}

function TZAbstractDatabaseInfo.GetIdentifierQuoteString: string;

begin

  Result := FIdentifierQuotes;

end;


{**

  Gets a comma-separated list of all a database's SQL keywords

  that are NOT also SQL92 keywords.

  @return the list

}

function TZAbstractDatabaseInfo.GetSQLKeywords: string;

begin

  Result := '';

end;


{**

  Gets a comma-separated list of math functions.  These are the

  X/Open CLI math function names used in the JDBC function escape

  clause.

  @return the list

}

function TZAbstractDatabaseInfo.GetNumericFunctions: string;

begin

  Result := '';

end;


{**

  Gets a comma-separated list of string functions.  These are the

  X/Open CLI string function names used in the JDBC function escape

  clause.

  @return the list

}

function TZAbstractDatabaseInfo.GetStringFunctions: string;

begin

  Result := '';

end;


{**

  Gets a comma-separated list of system functions.  These are the

  X/Open CLI system function names used in the JDBC function escape

  clause.

  @return the list

}

function TZAbstractDatabaseInfo.GetSystemFunctions: string;

begin

  Result := '';

end;


{**

  Gets a comma-separated list of time and date functions.

  @return the list

}

function TZAbstractDatabaseInfo.GetTimeDateFunctions: string;

begin

  Result := '';

end;


{**

  Gets the string that can be used to escape wildcard characters.

  This is the string that can be used to escape '_' or '%' in

  the string pattern style catalog search parameters.


  <P>The '_' character represents any single character.

  <P>The '%' character represents any sequence of zero or

  more characters.


  @return the string used to escape wildcard characters

}

function TZAbstractDatabaseInfo.GetSearchStringEscape: string;

begin

  Result := '%';

end;


{**

  Gets all the "extra" characters that can be used in unquoted

  identifier names (those beyond a-z, A-Z, 0-9 and _).

  @return the string containing the extra characters

}

function TZAbstractDatabaseInfo.GetExtraNameCharacters: string;

begin

  Result := '';

end;


//--------------------------------------------------------------------

// Functions describing which features are supported.


{**

  Is "ALTER TABLE" with add column supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsAlterTableWithAddColumn: Boolean;

begin

  Result := True;

end;


{**

  Is "ALTER TABLE" with drop column supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsAlterTableWithDropColumn: Boolean;

begin

  Result := True;

end;


{**

  Is column aliasing supported?


  <P>If so, the SQL AS clause can be used to provide names for

  computed columns or to provide alias names for columns as

  required.

  A JDBC Compliant<sup><font size=-2>TM</font></sup> driver always returns true.

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsColumnAliasing: Boolean;

begin

  Result := True;

end;


{**

  Are concatenations between NULL and non-NULL values NULL?

  For SQL-92 compliance, a JDBC technology-enabled driver will

  return <code>true</code>.

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.NullPlusNonNullIsNull: Boolean;

begin

  Result := True;

end;


{**

  Is the CONVERT function between SQL types supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsConvert: Boolean;

begin

  Result := False;

end;


{**

  Is CONVERT between the given SQL types supported?

  @param fromType the type to convert from

  @param toType the type to convert to

  @return <code>true</code> if so; <code>false</code> otherwise

  @see Types

}

function TZAbstractDatabaseInfo.SupportsConvertForTypes(

  FromType: TZSQLType; ToType: TZSQLType): Boolean;

begin

  Result := False;

end;


{**

  Are table correlation names supported?

  A JDBC Compliant<sup><font size=-2>TM</font></sup> driver always returns true.

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsTableCorrelationNames: Boolean;

begin

  Result := True;

end;


{**

  If table correlation names are supported, are they restricted

  to be different from the names of the tables?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsDifferentTableCorrelationNames: Boolean;

begin

  Result := False;

end;


{**

  Are expressions in "ORDER BY" lists supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsExpressionsInOrderBy: Boolean;

begin

  Result := True;

end;


{**

  Can an "ORDER BY" clause use columns not in the SELECT statement?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsOrderByUnrelated: Boolean;

begin

  Result := True;

end;


{**

  Is some form of "GROUP BY" clause supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsGroupBy: Boolean;

begin

  Result := True;

end;


{**

  Can a "GROUP BY" clause use columns not in the SELECT?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsGroupByUnrelated: Boolean;

begin

  Result := True;

end;


{**

  Can a "GROUP BY" clause add columns not in the SELECT

  provided it specifies all the columns in the SELECT?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsGroupByBeyondSelect: Boolean;

begin

  Result := False;

end;


{**

  Is the escape character in "LIKE" clauses supported?

  A JDBC Compliant<sup><font size=-2>TM</font></sup> driver always returns true.

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsLikeEscapeClause: Boolean;

begin

  Result := True;

end;


{**

  Are multiple <code>ResultSet</code> from a single execute supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsMultipleResultSets: Boolean;

begin

  Result := True;

end;


{**

  Can we have multiple transactions open at once (on different

  connections)?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsMultipleTransactions: Boolean;

begin

  Result := True;

end;


{**

  Can columns be defined as non-nullable?

  A JDBC Compliant<sup><font size=-2>TM</font></sup> driver always returns true.

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsNonNullableColumns: Boolean;

begin

  Result := True;

end;


{**

  Is the ODBC Minimum SQL grammar supported?

  All JDBC Compliant<sup><font size=-2>TM</font></sup> drivers must return true.

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsMinimumSQLGrammar: Boolean;

begin

  Result := True;

end;


{**

  Is the ODBC Core SQL grammar supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsCoreSQLGrammar: Boolean;

begin

  Result := True;

end;


{**

  Is the ODBC Extended SQL grammar supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsExtendedSQLGrammar: Boolean;

begin

  Result := True;

end;


{**

  Is the ANSI92 entry level SQL grammar supported?

  All JDBC Compliant<sup><font size=-2>TM</font></sup> drivers must return true.

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsANSI92EntryLevelSQL: Boolean;

begin

  Result := True;

end;


{**

  Is the ANSI92 intermediate SQL grammar supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsANSI92IntermediateSQL: Boolean;

begin

  Result := True;

end;


{**

  Is the ANSI92 full SQL grammar supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsANSI92FullSQL: Boolean;

begin

  Result := True;

end;


{**

  Is the SQL Integrity Enhancement Facility supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsIntegrityEnhancementFacility: Boolean;

begin

  Result := False;

end;


{**

  Is some form of outer join supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsOuterJoins: Boolean;

begin

  Result := True;

end;


{**

  Are full nested outer joins supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsFullOuterJoins: Boolean;

begin

  Result := True;

end;


{**

  Is there limited support for outer joins?  (This will be true

  if supportFullOuterJoins is true.)

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsLimitedOuterJoins: Boolean;

begin

  Result := True;

end;


{**

  What's the database vendor's preferred term for "schema"?

  @return the vendor term

}

function TZAbstractDatabaseInfo.GetSchemaTerm: string;

begin

  Result := 'Schema';

end;


{**

  What's the database vendor's preferred term for "procedure"?

  @return the vendor term

}

function TZAbstractDatabaseInfo.GetProcedureTerm: string;

begin

  Result := 'Procedure';

end;


{**

  What's the database vendor's preferred term for "catalog"?

  @return the vendor term

}

function TZAbstractDatabaseInfo.GetCatalogTerm: string;

begin

  Result := 'Catalog';

end;


{**

  Does a catalog appear at the start of a qualified table name?

  (Otherwise it appears at the end)

  @return true if it appears at the start

}

function TZAbstractDatabaseInfo.IsCatalogAtStart: Boolean;

begin

  Result := False;

end;


{**

  What's the separator between catalog and table name?

  @return the separator string

}

function TZAbstractDatabaseInfo.GetCatalogSeparator: string;

begin

  Result := '.';

end;


{**

  Can a schema name be used in a data manipulation statement?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsSchemasInDataManipulation: Boolean;

begin

  Result := False;

end;


{**

  Can a schema name be used in a procedure call statement?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsSchemasInProcedureCalls: Boolean;

begin

  Result := False;

end;


{**

  Can a schema name be used in a table definition statement?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsSchemasInTableDefinitions: Boolean;

begin

  Result := False;

end;


{**

  Can a schema name be used in an index definition statement?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsSchemasInIndexDefinitions: Boolean;

begin

  Result := False;

end;


{**

  Can a schema name be used in a privilege definition statement?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsSchemasInPrivilegeDefinitions: Boolean;

begin

  Result := False;

end;


{**

  Can a catalog name be used in a data manipulation statement?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsCatalogsInDataManipulation: Boolean;

begin

  Result := False;

end;


{**

  Can a catalog name be used in a procedure call statement?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsCatalogsInProcedureCalls: Boolean;

begin

  Result := False;

end;


{**

  Can a catalog name be used in a table definition statement?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsCatalogsInTableDefinitions: Boolean;

begin

  Result := False;

end;


{**

  Can a catalog name be used in an index definition statement?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsCatalogsInIndexDefinitions: Boolean;

begin

  Result := False;

end;


{**

  Can a catalog name be used in a privilege definition statement?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsCatalogsInPrivilegeDefinitions: Boolean;

begin

  Result := False;

end;


{**

  Can a stored procedure have an additional overload suffix?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsOverloadPrefixInStoredProcedureName: Boolean;

begin

  Result := False;

end;


{**

  Is positioned DELETE supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsPositionedDelete: Boolean;

begin

  Result := False;

end;


{**

  Is positioned UPDATE supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsPositionedUpdate: Boolean;

begin

  Result := False;

end;


{**

  Is SELECT for UPDATE supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsSelectForUpdate: Boolean;

begin

  Result := False;

end;


{**

  Are stored procedure calls using the stored procedure escape

  syntax supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsStoredProcedures: Boolean;

begin

  Result := False;

end;


{**

  Are subqueries in comparison expressions supported?

  A JDBC Compliant<sup><font size=-2>TM</font></sup> driver always returns true.

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsSubqueriesInComparisons: Boolean;

begin

  Result := False;

end;


{**

  Are subqueries in 'exists' expressions supported?

  A JDBC Compliant<sup><font size=-2>TM</font></sup> driver always returns true.

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsSubqueriesInExists: Boolean;

begin

  Result := False;

end;


{**

  Are subqueries in 'in' statements supported?

  A JDBC Compliant<sup><font size=-2>TM</font></sup> driver always returns true.

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsSubqueriesInIns: Boolean;

begin

  Result := False;

end;


{**

  Are subqueries in quantified expressions supported?

  A JDBC Compliant<sup><font size=-2>TM</font></sup> driver always returns true.

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsSubqueriesInQuantifieds: Boolean;

begin

  Result := False;

end;


{**

  Are correlated subqueries supported?

  A JDBC Compliant<sup><font size=-2>TM</font></sup> driver always returns true.

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsCorrelatedSubqueries: Boolean;

begin

  Result := False;

end;


{**

  Is SQL UNION supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsUnion: Boolean;

begin

  Result := False;

end;


{**

  Is SQL UNION ALL supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsUnionAll: Boolean;

begin

  Result := False;

end;


{**

  Can cursors remain open across commits?

  @return <code>true</code> if cursors always remain open;

        <code>false</code> if they might not remain open

}

function TZAbstractDatabaseInfo.SupportsOpenCursorsAcrossCommit: Boolean;

begin

  Result := False;

end;


{**

  Can cursors remain open across rollbacks?

  @return <code>true</code> if cursors always remain open;

        <code>false</code> if they might not remain open

}

function TZAbstractDatabaseInfo.SupportsOpenCursorsAcrossRollback: Boolean;

begin

  Result := False;

end;


{**

  Can statements remain open across commits?

  @return <code>true</code> if statements always remain open;

        <code>false</code> if they might not remain open

}

function TZAbstractDatabaseInfo.SupportsOpenStatementsAcrossCommit: Boolean;

begin

  Result := True;

end;


{**

  Can statements remain open across rollbacks?

  @return <code>true</code> if statements always remain open;

        <code>false</code> if they might not remain open

}

function TZAbstractDatabaseInfo.SupportsOpenStatementsAcrossRollback: Boolean;

begin

  Result := True;

end;


//----------------------------------------------------------------------

// The following group of methods exposes various limitations

// based on the target database with the current driver.

// Unless otherwise specified, a result of zero means there is no

// limit, or the limit is not known.


{**

  How many hex characters can you have in an inline binary literal?

  @return max binary literal length in hex characters;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxBinaryLiteralLength: Integer;

begin

  Result := 0;

end;


{**

  What's the max length for a character literal?

  @return max literal length;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxCharLiteralLength: Integer;

begin

  Result := 0;

end;


{**

  What's the limit on column name length?

  @return max column name length;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxColumnNameLength: Integer;

begin

  Result := 0;

end;


{**

  What's the maximum number of columns in a "GROUP BY" clause?

  @return max number of columns;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxColumnsInGroupBy: Integer;

begin

  Result := 0;

end;


{**

  What's the maximum number of columns allowed in an index?

  @return max number of columns;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxColumnsInIndex: Integer;

begin

  Result := 0;

end;


{**

  What's the maximum number of columns in an "ORDER BY" clause?

  @return max number of columns;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxColumnsInOrderBy: Integer;

begin

  Result := 0;

end;


{**

  What's the maximum number of columns in a "SELECT" list?

  @return max number of columns;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxColumnsInSelect: Integer;

begin

  Result := 0;

end;


{**

  What's the maximum number of columns in a table?

  @return max number of columns;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxColumnsInTable: Integer;

begin

  Result := 0;

end;


{**

  How many active connections can we have at a time to this database?

  @return max number of active connections;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxConnections: Integer;

begin

  Result := 0;

end;


{**

  What's the maximum cursor name length?

  @return max cursor name length in bytes;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxCursorNameLength: Integer;

begin

  Result := 0;

end;


{**

  Retrieves the maximum number of bytes for an index, including all

  of the parts of the index.

  @return max index length in bytes, which includes the composite of all

   the constituent parts of the index;

   a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxIndexLength: Integer;

begin

  Result := 0;

end;


{**

  What's the maximum length allowed for a schema name?

  @return max name length in bytes;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxSchemaNameLength: Integer;

begin

  Result := 0;

end;


{**

  What's the maximum length of a procedure name?

  @return max name length in bytes;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxProcedureNameLength: Integer;

begin

  Result := 0;

end;


{**

  What's the maximum length of a catalog name?

  @return max name length in bytes;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxCatalogNameLength: Integer;

begin

  Result := 0;

end;


{**

  What's the maximum length of a single row?

  @return max row size in bytes;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxRowSize: Integer;

begin

  Result := 0;

end;


{**

  Did getMaxRowSize() include LONGVARCHAR and LONGVARBINARY

  blobs?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.DoesMaxRowSizeIncludeBlobs: Boolean;

begin

  Result := True;

end;


{**

  What's the maximum length of an SQL statement?

  @return max length in bytes;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxStatementLength: Integer;

begin

  Result := 0;

end;


{**

  How many active statements can we have open at one time to this

  database?

  @return the maximum number of statements that can be open at one time;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxStatements: Integer;

begin

  Result := 0;

end;


{**

  What's the maximum length of a table name?

  @return max name length in bytes;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxTableNameLength: Integer;

begin

  Result := 0;

end;


{**

  What's the maximum number of tables in a SELECT statement?

  @return the maximum number of tables allowed in a SELECT statement;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxTablesInSelect: Integer;

begin

  Result := 0;

end;


{**

  What's the maximum length of a user name?

  @return max user name length  in bytes;

       a result of zero means that there is no limit or the limit is not known

}

function TZAbstractDatabaseInfo.GetMaxUserNameLength: Integer;

begin

  Result := 0;

end;


//----------------------------------------------------------------------


{**

  What's the database's default transaction isolation level?  The

  values are defined in <code>java.sql.Connection</code>.

  @return the default isolation level

  @see Connection

}

function TZAbstractDatabaseInfo.GetDefaultTransactionIsolation:

  TZTransactIsolationLevel;

begin

  Result := tiReadCommitted;

end;


{**

  Are transactions supported? If not, invoking the method

  <code>commit</code> is a noop and the isolation level is TRANSACTION_NONE.

  @return <code>true</code> if transactions are supported; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsTransactions: Boolean;

begin

  Result := True;

end;


{**

  Does this database support the given transaction isolation level?

  @param level the values are defined in <code>java.sql.Connection</code>

  @return <code>true</code> if so; <code>false</code> otherwise

  @see Connection

}

function TZAbstractDatabaseInfo.SupportsTransactionIsolationLevel(

  Level: TZTransactIsolationLevel): Boolean;

begin

  Result := True;

end;


{**

  Are both data definition and data manipulation statements

  within a transaction supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.

  SupportsDataDefinitionAndDataManipulationTransactions: Boolean;

begin

  Result := True;

end;


{**

  Are only data manipulation statements within a transaction

  supported?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.

  SupportsDataManipulationTransactionsOnly: Boolean;

begin

  Result := False;

end;


{**

  Does a data definition statement within a transaction force the

  transaction to commit?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.DataDefinitionCausesTransactionCommit: Boolean;

begin

  Result := True;

end;


{**

  Is a data definition statement within a transaction ignored?

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.DataDefinitionIgnoredInTransactions: Boolean;

begin

  Result := False;

end;


{**

  Does the database support the given result set type?

  @param type defined in <code>java.sql.ResultSet</code>

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsResultSetType(

  _Type: TZResultSetType): Boolean;

begin

  Result := True;

end;


{**

  Does the database support the concurrency type in combination

  with the given result set type?


  @param type defined in <code>java.sql.ResultSet</code>

  @param concurrency type defined in <code>java.sql.ResultSet</code>

  @return <code>true</code> if so; <code>false</code> otherwise

}

function TZAbstractDatabaseInfo.SupportsResultSetConcurrency(

  _Type: TZResultSetType; Concurrency: TZResultSetConcurrency): Boolean;

begin

  Result := True;

end;


{**

  Indicates whether the driver supports batch updates.

  @return true if the driver supports batch updates; false otherwise

}

function TZAbstractDatabaseInfo.SupportsBatchUpdates: Boolean;

begin

  Result := True;

end;


{**

  Does the Database or Actual Version understand non escaped search strings?

  @return <code>true</code> if the DataBase does understand non escaped

  search strings

}

function TZAbstractDatabaseInfo.SupportsNonEscapedSearchStrings: Boolean;

begin

  Result := False;

end;


{**

  Does the Database support updating auto incremental fields?

  @return <code>true</code> if the DataBase allows it.

}

function TZAbstractDatabaseInfo.SupportsUpdateAutoIncrementFields: Boolean;

begin

  Result := True;

end;


{ TZAbstractDatabaseMetadata }


{**

  Constructs this object and assignes the main properties.

  @param Connection a database connection object.

  @param Url a database connection url string.

}

constructor TZAbstractDatabaseMetadata.Create(Connection: TZAbstractConnection;

  const Url: TZURL);

begin

  inherited Create(Connection as IZConnection);

  FIC := Self.GetIdentifierConvertor;

  FConnection := Pointer(Connection as IZConnection);

  FUrl := Url;

  FCachedResultSets := TZHashMap.Create;

  FDatabaseInfo := CreateDatabaseInfo;

  FDatabase := Url.Database;

  FConSettings := IZConnection(FConnection).GetConSettings;

  FillWildcards;

end;


function TZAbstractDatabaseMetadata.GetInfo: TStrings;

begin

  Result := FURL.Properties;

end;


function TZAbstractDatabaseMetadata.GetURLString: String;

begin

  Result := FURL.URL;

end;


{**

   Remove escapes from pattren string

   @param Pattern a sql pattern

   @return string without escapes

}

function TZAbstractDatabaseMetadata.StripEscape(const Pattern: string): string;

var

  I: Integer;

  PreviousChar: Char;

  EscapeChar: string;

begin

  PreviousChar := #0;

  Result := '';

  EscapeChar := GetDatabaseInfo.GetSearchStringEscape;

  for I := 1 to Length(Pattern) do

  begin

    if (Pattern[i] <> EscapeChar) then

    begin

      Result := Result + Pattern[I];

      PreviousChar := Pattern[I];

    end

    else

    begin

      if (PreviousChar = EscapeChar) then

      begin

        Result := Result + Pattern[I];

        PreviousChar := #0;

      end

      else

        PreviousChar := Pattern[i];

    end;

  end;

end;


{**

   Check if pattern does not contain wildcards

   @param Pattern a sql pattern

   @return if pattern contain wildcards return true otherwise false

}

function TZAbstractDatabaseMetadata.HasNoWildcards(const Pattern: string

  ): boolean;

var

  I: Integer;

  PreviousCharWasEscape: Boolean;

  EscapeChar,PreviousChar: Char;

  WildcardsSet: TZWildcardsSet;

begin

  Result := False;

  PreviousChar := #0;

  PreviousCharWasEscape := False;

  EscapeChar := Char(GetDatabaseInfo.GetSearchStringEscape[1]);

  WildcardsSet := GetWildcardsSet;

  for I := 1 to Length(Pattern) do

  begin

    if (not PreviousCharWasEscape) and CharInset(Pattern[I], WildcardsSet) then

     Exit;


    PreviousCharWasEscape := (Pattern[I] = EscapeChar) and (PreviousChar <> EscapeChar);

    if (PreviousCharWasEscape) and (Pattern[I] = EscapeChar) then

      PreviousChar := #0

    else

      PreviousChar := Pattern[I];

  end;

  Result := True;

end;


function TZAbstractDatabaseMetadata.EscapeString(const S: string): string;

begin

  Result := '''' + S + '''';

end;


function TZAbstractDatabaseMetadata.DecomposeObjectString(const S: String): String;

begin

  if IC.IsQuoted(s) then

    Result := IC.ExtractQuote(s)

  else

    Result := s;

end;


{**  Destroys this object and cleanups the memory.}

destructor TZAbstractDatabaseMetadata.Destroy;

begin

  FIC := nil;

  FUrl := nil;

  FCachedResultSets.Clear;

  FCachedResultSets := nil;

  FDatabaseInfo := nil;


  inherited Destroy;

end;


{**

  Constructs a database information object and returns the interface to it. Used

  internally by the constructor.

  @return the database information object interface

}

function TZAbstractDatabaseMetadata.CreateDatabaseInfo: IZDatabaseInfo;

begin

  Result := TZAbstractDatabaseInfo.Create(Self);

end;


{**

  Creates and returns a statement object.

  @return the statement object

}

function TZAbstractDatabaseMetadata.GetStatement: IZSTatement;

begin

  Result := GetConnection.CreateStatement;

end;


{**

  Retrieves the connection that produced this metadata object.

  @return the connection that produced this metadata object

}

function TZAbstractDatabaseMetadata.GetConnection: IZConnection;

begin

  Result := IZConnection(FConnection);

end;


{**

  Constructs a virtual result set object.

  @param ColumnsDefs an array of column definition objects.

  @return a created result set.

}

function TZAbstractDatabaseMetadata.ConstructVirtualResultSet(

  ColumnsDefs: TZMetadataColumnDefs): IZVirtualResultSet;

var

  I: Integer;

  ColumnInfo: TZColumnInfo;

  ColumnsInfo: TObjectList;

begin

  ColumnsInfo := TObjectList.Create(True);

  try

    for I := 0 to High(ColumnsDefs) do

    begin

      ColumnInfo := TZColumnInfo.Create;

      with ColumnInfo do

      begin

        ColumnLabel := ColumnsDefs[I].Name;

        ColumnType := ColumnsDefs[I].SQLType;

        ColumnDisplaySize := ColumnsDefs[I].Length;

        Precision := ColumnsDefs[I].Length;

      end;

      ColumnsInfo.Add(ColumnInfo);

    end;


    Result := TZVirtualResultSet.CreateWithColumns(ColumnsInfo, '',

      IZConnection(FConnection).GetConSettings);

    with Result do

    begin

      SetType(rtScrollInsensitive);

      SetConcurrency(rcUpdatable);

    end;

  finally

    ColumnsInfo.Free;

  end;

end;


{**

  Clears all cached metadata.

}

procedure TZAbstractDatabaseMetadata.ClearCache;

begin

  FCachedResultSets.Clear;

end;


{**

  Clears specific cached metadata.

}

procedure TZAbstractDatabaseMetadata.ClearCache(const Key: string);

var

  TempKey: IZAnyValue;

begin

  TempKey := TZAnyValue.CreateWithString(Key);

  FCachedResultSets.Remove(TempKey);

end;


{**

  Adds resultset to the internal cache.

  @param Key a resultset unique key value.

  @param ResultSet a resultset interface.

}

procedure TZAbstractDatabaseMetadata.AddResultSetToCache(const Key: string;

  ResultSet: IZResultSet);

var

  TempKey: IZAnyValue;

begin

  TempKey := TZAnyValue.CreateWithString(Key);

  FCachedResultSets.Put(TempKey, CloneCachedResultSet(ResultSet));

end;


{**

  Gets a resultset interface from the internal cache by key.

  @param Key a resultset unique key value.

  @returns a cached resultset interface or <code>nil</code> otherwise.

}

function TZAbstractDatabaseMetadata.GetResultSetFromCache(

  const Key: string): IZResultSet;

var

  TempKey: IZAnyValue;

begin

  TempKey := TZAnyValue.CreateWithString(Key);

  Result := FCachedResultSets.Get(TempKey) as IZResultSet;

  if Result <> nil then

    Result := CloneCachedResultSet(Result);

end;


{**

  Copies on result set to another one from the current position.

  @param SrcResultSet a source result set.

  @param DestResultSet a destination result set.

  @returns a destination result set.

}

function TZAbstractDatabaseMetadata.CopyToVirtualResultSet(

  SrcResultSet: IZResultSet; DestResultSet: IZVirtualResultSet):

  IZVirtualResultSet;

var

  I: Integer;

  Metadata: IZResultSetMetadata;

begin

  DestResultSet.SetType(rtScrollInsensitive);

  DestResultSet.SetConcurrency(rcUpdatable);


  Metadata := SrcResultSet.GetMetadata;

  while SrcResultSet.Next do

  begin

    DestResultSet.MoveToInsertRow;

    for I := 1 to Metadata.GetColumnCount do

    begin

      case Metadata.GetColumnType(I) of

        stBoolean:

          DestResultSet.UpdateBoolean(I, SrcResultSet.GetBoolean(I));

        stByte:

          DestResultSet.UpdateByte(I, SrcResultSet.GetByte(I));

        stShort:

          DestResultSet.UpdateShort(I, SrcResultSet.GetShort(I));

        stInteger:

          DestResultSet.UpdateInt(I, SrcResultSet.GetInt(I));

        stLong:

          DestResultSet.UpdateLong(I, SrcResultSet.GetLong(I));

        stFloat:

          DestResultSet.UpdateFloat(I, SrcResultSet.GetFloat(I));

        stDouble:

          DestResultSet.UpdateDouble(I, SrcResultSet.GetDouble(I));

        stBigDecimal:

          DestResultSet.UpdateBigDecimal(I, SrcResultSet.GetBigDecimal(I));

        stString:

          DestResultSet.UpdateString(I, SrcResultSet.GetString(I));

        stUnicodeString:

          DestResultSet.UpdateUnicodeString(I, SrcResultSet.GetUnicodeString(I));

        stBytes:

          DestResultSet.UpdateBytes(I, SrcResultSet.GetBytes(I));

        stDate:

          DestResultSet.UpdateDate(I, SrcResultSet.GetDate(I));

        stTime:

          DestResultSet.UpdateTime(I, SrcResultSet.GetTime(I));

        stTimestamp:

          DestResultSet.UpdateTimestamp(I, SrcResultSet.GetTimestamp(I));

        stAsciiStream,

        stUnicodeStream,

        stBinaryStream:

          DestResultSet.UpdateString(I, SrcResultSet.GetString(I));

      end;

      if SrcResultSet.WasNull then

        DestResultSet.UpdateNull(I);

    end;

    DestResultSet.InsertRow;

  end;


  DestResultSet.BeforeFirst;

  DestResultSet.SetConcurrency(rcReadOnly);

  Result := DestResultSet;

end;


{**

  Clones the cached resultset.

  @param ResultSet the resultset to be cloned.

  @returns the clone of the specified resultset.

}

function TZAbstractDatabaseMetadata.CloneCachedResultSet(

  ResultSet: IZResultSet): IZResultSet;

var

  I: Integer;

  Metadata: IZResultSetMetadata;

  ColumnInfo: TZColumnInfo;

  ColumnsInfo: TObjectList;

begin

  Result := nil;

  Metadata := ResultSet.GetMetadata;

  ColumnsInfo := TObjectList.Create(True);

  try

    for I := 1 to Metadata.GetColumnCount do

    begin

      ColumnInfo := TZColumnInfo.Create;

      with ColumnInfo do

      begin

        ColumnLabel := Metadata.GetColumnLabel(I);

        ColumnType := Metadata.GetColumnType(I);

        ColumnDisplaySize := Metadata.GetPrecision(I);

        Precision := Metadata.GetPrecision(I);

      end;

      ColumnsInfo.Add(ColumnInfo);

    end;


    ResultSet.BeforeFirst;

    Result := CopyToVirtualResultSet(ResultSet,

      TZVirtualResultSet.CreateWithColumns(ColumnsInfo, '',

        IZConnection(Self.FConnection).GetConSettings));

    ResultSet.BeforeFirst;

  finally

    ColumnsInfo.Free;

  end;

end;


{**

   Takes a name patternand column name and retuen an appropriate SQL clause

    @param Pattern a sql pattren

    @parma Column a sql column name

    @return processed string for query

}

function TZAbstractDatabaseMetadata.ConstructNameCondition(Pattern: string;

  Column: string): string;

const

  Spaces = '';

var

  WorkPattern: string;

begin

  Result := '';

  if (Length(Pattern) > 2 * 31) then

    raise EZSQLException.Create(SPattern2Long);


  if (Pattern = '%') or (Pattern = '') then

     Exit;

  WorkPattern:=NormalizePatternCase(Pattern);

  if HasNoWildcards(WorkPattern) then

  begin

    WorkPattern := StripEscape(WorkPattern);

    Result := Format('%s = %s', [Column, EscapeString(WorkPattern)]);

  end

  else

  begin

    Result := Format('%s like %s',

      [Column, EscapeString(WorkPattern+'%')]);

  end;

end;


{**

  What's the url for this database?

  @return the url or null if it cannot be generated

}

function TZAbstractDatabaseMetadata.GetURL: string;

begin

  Result := GetURLString;

end;


{**

  What's our user name as known to the database?

  @return our database user name

}

function TZAbstractDatabaseMetadata.GetUserName: string;

begin

  Result := FURL.UserName;

end;


{**

  Returns general information about the database (version, capabilities,

  policies, etc).

  @return the database information object interface.

}

function TZAbstractDatabaseMetadata.GetDatabaseInfo: IZDatabaseInfo;

begin

  Result := FDatabaseInfo;

end;


{**

  Gets a description of the stored procedures available in a

  catalog.


  <P>Only procedure descriptions matching the schema and

  procedure name criteria are returned.  They are ordered by

  PROCEDURE_SCHEM, and PROCEDURE_NAME.


  <P>Each procedure description has the the following columns:

   <OL>

   <LI><B>PROCEDURE_CAT</B> String => procedure catalog (may be null)

   <LI><B>PROCEDURE_SCHEM</B> String => procedure schema (may be null)

   <LI><B>PROCEDURE_NAME</B> String => procedure name

   <LI> reserved for future use

   <LI> reserved for future use

   <LI> reserved for future use

   <LI><B>REMARKS</B> String => explanatory comment on the procedure

   <LI><B>PROCEDURE_TYPE</B> short => kind of procedure:

       <UL>

       <LI> procedureResultUnknown - May return a result

       <LI> procedureNoResult - Does not return a result

       <LI> procedureReturnsResult - Returns a result

       </UL>

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schemaPattern a schema name pattern; "" retrieves those

  without a schema

  @param procedureNamePattern a procedure name pattern

  @return <code>ResultSet</code> - each row is a procedure description

  @see #getSearchStringEscape

}

function TZAbstractDatabaseMetadata.GetProcedures(const Catalog: string;

  const SchemaPattern: string; const ProcedureNamePattern: string): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(ProceduresColumnsDynArray);

    exit;

  end;


  Key := GetProceduresCacheKey(Catalog, SchemaPattern, ProcedureNamePattern);


  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetProcedures(Catalog, SchemaPattern, ProcedureNamePattern);

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets a description of the stored procedures available in a

  catalog.


  <P>Only procedure descriptions matching the schema and

  procedure name criteria are returned.  They are ordered by

  PROCEDURE_SCHEM, and PROCEDURE_NAME.


  <P>Each procedure description has the the following columns:

   <OL>

   <LI><B>PROCEDURE_CAT</B> String => procedure catalog (may be null)

   <LI><B>PROCEDURE_SCHEM</B> String => procedure schema (may be null)

   <LI><B>PROCEDURE_NAME</B> String => procedure name

   <LI> reserved for future use

   <LI> reserved for future use

   <LI> reserved for future use

   <LI><B>REMARKS</B> String => explanatory comment on the procedure

   <LI><B>PROCEDURE_TYPE</B> short => kind of procedure:

       <UL>

       <LI> procedureResultUnknown - May return a result

       <LI> procedureNoResult - Does not return a result

       <LI> procedureReturnsResult - Returns a result

       </UL>

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schemaPattern a schema name pattern; "" retrieves those

  without a schema

  @param procedureNamePattern a procedure name pattern

  @return <code>ResultSet</code> - each row is a procedure description

  @see #getSearchStringEscape

}

function TZAbstractDatabaseMetadata.UncachedGetProcedures(const Catalog: string;

  const SchemaPattern: string; const ProcedureNamePattern: string): IZResultSet;

begin

    Result := ConstructVirtualResultSet(ProceduresColumnsDynArray);

end;


{**

  Gets a description of a catalog's stored procedure parameters

  and result columns.


  <P>Only descriptions matching the schema, procedure and

  parameter name criteria are returned.  They are ordered by

  PROCEDURE_SCHEM and PROCEDURE_NAME. Within this, the return value,

  if any, is first. Next are the parameter descriptions in call

  order. The column descriptions follow in column number order.


  <P>Each row in the <code>ResultSet</code> is a parameter description or

  column description with the following fields:

   <OL>

   <LI><B>PROCEDURE_CAT</B> String => procedure catalog (may be null)

   <LI><B>PROCEDURE_SCHEM</B> String => procedure schema (may be null)

   <LI><B>PROCEDURE_NAME</B> String => procedure name

   <LI><B>COLUMN_NAME</B> String => column/parameter name

   <LI><B>COLUMN_TYPE</B> Short => kind of column/parameter:

       <UL>

       <LI> procedureColumnUnknown - nobody knows

       <LI> procedureColumnIn - IN parameter

       <LI> procedureColumnInOut - INOUT parameter

       <LI> procedureColumnOut - OUT parameter

       <LI> procedureColumnReturn - procedure return value

       <LI> procedureColumnResult - result column in <code>ResultSet</code>

       </UL>

   <LI><B>DATA_TYPE</B> short => SQL type from java.sql.Types

   <LI><B>TYPE_NAME</B> String => SQL type name, for a UDT type the

   type name is fully qualified

   <LI><B>PRECISION</B> int => precision

   <LI><B>LENGTH</B> int => length in bytes of data

   <LI><B>SCALE</B> short => scale

   <LI><B>RADIX</B> short => radix

   <LI><B>NULLABLE</B> short => can it contain NULL?

       <UL>

       <LI> procedureNoNulls - does not allow NULL values

       <LI> procedureNullable - allows NULL values

       <LI> procedureNullableUnknown - nullability unknown

       </UL>

   <LI><B>REMARKS</B> String => comment describing parameter/column

   </OL>


  <P><B>Note:</B> Some databases may not return the column

  descriptions for a procedure. Additional columns beyond

  REMARKS can be defined by the database.


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schemaPattern a schema name pattern; "" retrieves those

  without a schema

  @param procedureNamePattern a procedure name pattern

  @param columnNamePattern a column name pattern

  @return <code>ResultSet</code> - each row describes a stored procedure parameter or

       column

  @see #getSearchStringEscape

}

function TZAbstractDatabaseMetadata.GetProcedureColumns(const Catalog: string;

  const SchemaPattern: string; const ProcedureNamePattern: string;

  const ColumnNamePattern: string): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(ProceduresColColumnsDynArray);

    exit;

  end;


  Key := GetProcedureColumnsCacheKey(Catalog, SchemaPattern, ProcedureNamePattern,

    ColumnNamePattern);

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetProcedureColumns(Catalog, SchemaPattern, ProcedureNamePattern, ColumnNamePattern);

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets a description of a catalog's stored procedure parameters

  and result columns.


  <P>Only descriptions matching the schema, procedure and

  parameter name criteria are returned.  They are ordered by

  PROCEDURE_SCHEM and PROCEDURE_NAME. Within this, the return value,

  if any, is first. Next are the parameter descriptions in call

  order. The column descriptions follow in column number order.


  <P>Each row in the <code>ResultSet</code> is a parameter description or

  column description with the following fields:

   <OL>

   <LI><B>PROCEDURE_CAT</B> String => procedure catalog (may be null)

   <LI><B>PROCEDURE_SCHEM</B> String => procedure schema (may be null)

   <LI><B>PROCEDURE_NAME</B> String => procedure name

   <LI><B>COLUMN_NAME</B> String => column/parameter name

   <LI><B>COLUMN_TYPE</B> Short => kind of column/parameter:

       <UL>

       <LI> procedureColumnUnknown - nobody knows

       <LI> procedureColumnIn - IN parameter

       <LI> procedureColumnInOut - INOUT parameter

       <LI> procedureColumnOut - OUT parameter

       <LI> procedureColumnReturn - procedure return value

       <LI> procedureColumnResult - result column in <code>ResultSet</code>

       </UL>

   <LI><B>DATA_TYPE</B> short => SQL type from java.sql.Types

   <LI><B>TYPE_NAME</B> String => SQL type name, for a UDT type the

   type name is fully qualified

   <LI><B>PRECISION</B> int => precision

   <LI><B>LENGTH</B> int => length in bytes of data

   <LI><B>SCALE</B> short => scale

   <LI><B>RADIX</B> short => radix

   <LI><B>NULLABLE</B> short => can it contain NULL?

       <UL>

       <LI> procedureNoNulls - does not allow NULL values

       <LI> procedureNullable - allows NULL values

       <LI> procedureNullableUnknown - nullability unknown

       </UL>

   <LI><B>REMARKS</B> String => comment describing parameter/column

   </OL>


  <P><B>Note:</B> Some databases may not return the column

  descriptions for a procedure. Additional columns beyond

  REMARKS can be defined by the database.


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schemaPattern a schema name pattern; "" retrieves those

  without a schema

  @param procedureNamePattern a procedure name pattern

  @param columnNamePattern a column name pattern

  @return <code>ResultSet</code> - each row describes a stored procedure parameter or

       column

  @see #getSearchStringEscape

}

function TZAbstractDatabaseMetadata.UncachedGetProcedureColumns(const Catalog: string;

  const SchemaPattern: string; const ProcedureNamePattern: string;

  const ColumnNamePattern: string): IZResultSet;

begin

    Result := ConstructVirtualResultSet(ProceduresColColumnsDynArray);

end;


function TZAbstractDatabaseMetadata.GetTriggers(const Catalog: string; const SchemaPattern: string;

  const TableNamePattern: string; const TriggerNamePattern: string): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(TriggersColumnsDynArray);

    exit;

  end;


  Key := GetTriggersCacheKey(Catalog, SchemaPattern, TableNamePattern, TriggerNamePattern);

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetTriggers(Catalog, SchemaPattern, TableNamePattern, TriggerNamePattern);

    AddResultSetToCache(Key, Result);

  end;

end;


function TZAbstractDatabaseMetadata.UncachedGetTriggers(const Catalog: string; const SchemaPattern: string;

  const TableNamePattern: string; const TriggerNamePattern: string): IZResultSet;

begin

  Result := ConstructVirtualResultSet(TriggersColumnsDynArray);

end;


function TZAbstractDatabaseMetadata.GetCollationAndCharSet(const Catalog, Schema,

  TableName, ColumnName: String): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(CollationCharSetColumnsDynArray);

    exit;

  end;


  Key := GetCollationAndCharSetCacheKey(Catalog, Schema, TableName, ColumnName);

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetCollationAndCharSet(Catalog, Schema, TableName, ColumnName);

    AddResultSetToCache(Key, Result);

  end;

end;


function TZAbstractDatabaseMetadata.GetCharacterSets: IZResultSet; //EgonHugeist

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(CharacterSetsColumnsDynArray);

    exit;

  end;


  Key := GetCharacterSetsCacheKey;

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetCharacterSets;

    AddResultSetToCache(Key, Result);

  end;

end;


function TZAbstractDatabaseMetadata.UncachedGetCollationAndCharSet(const Catalog, SchemaPattern,

  TableNamePattern, ColumnNamePattern: string): IZResultSet;

begin

  Result := ConstructVirtualResultSet(CollationCharSetColumnsDynArray);

end;


function TZAbstractDatabaseMetadata.UncachedGetCharacterSets: IZResultSet; //EgonHugeist

begin

  Result := ConstructVirtualResultSet(CharacterSetsColumnsDynArray);

end;


function TZAbstractDatabaseMetadata.GetCollationAndCharSetCacheKey(const Catalog, SchemaPattern,

  TableNamePattern, ColumnPattern: String): string;

begin

  Result := Format('get-CollationAndCharSet:%s:%s:%s:%s',

    [Catalog, SchemaPattern, TableNamePattern, ColumnPattern]);

end;


function TZAbstractDatabaseMetadata.GetCharacterSetsCacheKey: String; //EgonHugeist

begin

  Result := 'get-charactersets';

end;


function TZAbstractDatabaseMetadata.GetTriggersCacheKey(const Catalog: string;

  const SchemaPattern: string; const TableNamePattern: string;

  const TriggerNamePattern: string): string;

begin

  Result := Format('get-trigger:%s:%s:%s:%s',

    [Catalog, SchemaPattern, TableNamePattern, TriggerNamePattern]);

end;


{**

  Gets a description of tables available in a catalog.


  <P>Only table descriptions matching the catalog, schema, table

  name and type criteria are returned.  They are ordered by

  TABLE_TYPE, TABLE_SCHEM and TABLE_NAME.


  <P>Each table description has the following columns:

   <OL>

   <LI><B>TABLE_CAT</B> String => table catalog (may be null)

   <LI><B>TABLE_SCHEM</B> String => table schema (may be null)

   <LI><B>TABLE_NAME</B> String => table name

   <LI><B>TABLE_TYPE</B> String => table type.  Typical types are "TABLE",

                   "VIEW", "SYSTEM TABLE", "GLOBAL TEMPORARY",

                   "LOCAL TEMPORARY", "ALIAS", "SYNONYM".

   <LI><B>REMARKS</B> String => explanatory comment on the table

   </OL>


  <P><B>Note:</B> Some databases may not return information for

  all tables.


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schemaPattern a schema name pattern; "" retrieves those

  without a schema

  @param tableNamePattern a table name pattern

  @param types a list of table types to include; null returns all types

  @return <code>ResultSet</code> - each row is a table description

  @see #getSearchStringEscape

}

function TZAbstractDatabaseMetadata.GetTables(const Catalog: string;

  const SchemaPattern: string; const TableNamePattern: string;

  const Types: TStringDynArray): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(TableColumnsDynArray);

    exit;

  end;


  Key := GetTablesCacheKey(Catalog, SchemaPattern, TableNamePattern, Types);

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetTables(Catalog, SchemaPattern, TableNamePattern, Types);

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets a description of tables available in a catalog.


  <P>Only table descriptions matching the catalog, schema, table

  name and type criteria are returned.  They are ordered by

  TABLE_TYPE, TABLE_SCHEM and TABLE_NAME.


  <P>Each table description has the following columns:

   <OL>

   <LI><B>TABLE_CAT</B> String => table catalog (may be null)

   <LI><B>TABLE_SCHEM</B> String => table schema (may be null)

   <LI><B>TABLE_NAME</B> String => table name

   <LI><B>TABLE_TYPE</B> String => table type.  Typical types are "TABLE",

                   "VIEW", "SYSTEM TABLE", "GLOBAL TEMPORARY",

                   "LOCAL TEMPORARY", "ALIAS", "SYNONYM".

   <LI><B>REMARKS</B> String => explanatory comment on the table

   </OL>


  <P><B>Note:</B> Some databases may not return information for

  all tables.


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schemaPattern a schema name pattern; "" retrieves those

  without a schema

  @param tableNamePattern a table name pattern

  @param types a list of table types to include; null returns all types

  @return <code>ResultSet</code> - each row is a table description

  @see #getSearchStringEscape

}

function TZAbstractDatabaseMetadata.UncachedGetTables(const Catalog: string;

  const SchemaPattern: string; const TableNamePattern: string;

  const Types: TStringDynArray): IZResultSet;

begin

  Result := ConstructVirtualResultSet(TableColumnsDynArray);

end;


{**

  Gets the schema names available in this database.  The results

  are ordered by schema name.


  <P>The schema column is:

   <OL>

   <LI><B>TABLE_SCHEM</B> String => schema name

   </OL>


  @return <code>ResultSet</code> - each row has a single String column that is a

  schema name

}

function TZAbstractDatabaseMetadata.GetSchemas: IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(SchemaColumnsDynArray);

    exit;

  end;


  Key := GetSchemasCacheKey;

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetSchemas;

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets the schema names available in this database.  The results

  are ordered by schema name.


  <P>The schema column is:

   <OL>

   <LI><B>TABLE_SCHEM</B> String => schema name

   </OL>


  @return <code>ResultSet</code> - each row has a single String column that is a

  schema name

}

function TZAbstractDatabaseMetadata.UncachedGetSchemas: IZResultSet;

begin

    Result := ConstructVirtualResultSet(SchemaColumnsDynArray);

end;


{**

  Gets the catalog names available in this database.  The results

  are ordered by catalog name.


  <P>The catalog column is:

   <OL>

   <LI><B>TABLE_CAT</B> String => catalog name

   </OL>


  @return <code>ResultSet</code> - each row has a single String column that is a

  catalog name

}

function TZAbstractDatabaseMetadata.GetCatalogs: IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(CatalogColumnsDynArray);

    exit;

  end;


  Key := GetCatalogsCacheKey;

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetCatalogs;

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets the catalog names available in this database.  The results

  are ordered by catalog name.


  <P>The catalog column is:

   <OL>

   <LI><B>TABLE_CAT</B> String => catalog name

   </OL>


  @return <code>ResultSet</code> - each row has a single String column that is a

  catalog name

}

function TZAbstractDatabaseMetadata.UncachedGetCatalogs: IZResultSet;

begin

    Result := ConstructVirtualResultSet(CatalogColumnsDynArray);

end;


{**

  Gets the table types available in this database.  The results

  are ordered by table type.


  <P>The table type is:

   <OL>

   <LI><B>TABLE_TYPE</B> String => table type.  Typical types are "TABLE",

                   "VIEW", "SYSTEM TABLE", "GLOBAL TEMPORARY",

                   "LOCAL TEMPORARY", "ALIAS", "SYNONYM".

   </OL>


  @return <code>ResultSet</code> - each row has a single String column that is a

  table type

}

function TZAbstractDatabaseMetadata.GetTableTypes: IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(TableTypeColumnsDynArray);

    exit;

  end;


  Key := GetTableTypesCacheKey;

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetTableTypes;

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets the table types available in this database.  The results

  are ordered by table type.


  <P>The table type is:

   <OL>

   <LI><B>TABLE_TYPE</B> String => table type.  Typical types are "TABLE",

                   "VIEW", "SYSTEM TABLE", "GLOBAL TEMPORARY",

                   "LOCAL TEMPORARY", "ALIAS", "SYNONYM".

   </OL>


  @return <code>ResultSet</code> - each row has a single String column that is a

  table type

}

function TZAbstractDatabaseMetadata.UncachedGetTableTypes: IZResultSet;

begin

    Result := ConstructVirtualResultSet(TableTypeColumnsDynArray);

end;


{**

  Gets a description of table columns available in

  the specified catalog.


  <P>Only column descriptions matching the catalog, schema, table

  and column name criteria are returned.  They are ordered by

  TABLE_SCHEM, TABLE_NAME and ORDINAL_POSITION.


  <P>Each column description has the following columns:

   <OL>

   <LI><B>TABLE_CAT</B> String => table catalog (may be null)

   <LI><B>TABLE_SCHEM</B> String => table schema (may be null)

   <LI><B>TABLE_NAME</B> String => table name

   <LI><B>COLUMN_NAME</B> String => column name

   <LI><B>DATA_TYPE</B> short => SQL type from java.sql.Types

   <LI><B>TYPE_NAME</B> String => Data source dependent type name,

   for a UDT the type name is fully qualified

   <LI><B>COLUMN_SIZE</B> int => column size.  For char or date

       types this is the maximum number of characters, for numeric or

       decimal types this is precision.

   <LI><B>BUFFER_LENGTH</B> is not used.

   <LI><B>DECIMAL_DIGITS</B> int => the number of fractional digits

   <LI><B>NUM_PREC_RADIX</B> int => Radix (typically either 10 or 2)

   <LI><B>NULLABLE</B> int => is NULL allowed?

       <UL>

       <LI> columnNoNulls - might not allow NULL values

       <LI> columnNullable - definitely allows NULL values

       <LI> columnNullableUnknown - nullability unknown

       </UL>

   <LI><B>REMARKS</B> String => comment describing column (may be null)

   <LI><B>COLUMN_DEF</B> String => default value (may be null)

   <LI><B>SQL_DATA_TYPE</B> int => unused

   <LI><B>SQL_DATETIME_SUB</B> int => unused

   <LI><B>CHAR_OCTET_LENGTH</B> int => for char types the

        maximum number of bytes in the column

   <LI><B>ORDINAL_POSITION</B> int => index of column in table

       (starting at 1)

   <LI><B>IS_NULLABLE</B> String => "NO" means column definitely

       does not allow NULL values; "YES" means the column might

       allow NULL values.  An empty string means nobody knows.

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schemaPattern a schema name pattern; "" retrieves those

  without a schema

  @param tableNamePattern a table name pattern

  @param columnNamePattern a column name pattern

  @return <code>ResultSet</code> - each row is a column description

  @see #getSearchStringEscape

}

function TZAbstractDatabaseMetadata.GetColumns(const Catalog: string;

  const SchemaPattern: string; const TableNamePattern: string;

  const ColumnNamePattern: string): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(TableColColumnsDynArray);

    exit;

  end;


  Key := GetColumnsCacheKey(Catalog, SchemaPattern, TableNamePattern,

    ColumnNamePattern);

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetColumns(Catalog, SchemaPattern, TableNamePattern, ColumnNamePattern);

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets a description of table columns available in

  the specified catalog.


  <P>Only column descriptions matching the catalog, schema, table

  and column name criteria are returned.  They are ordered by

  TABLE_SCHEM, TABLE_NAME and ORDINAL_POSITION.


  <P>Each column description has the following columns:

   <OL>

   <LI><B>TABLE_CAT</B> String => table catalog (may be null)

   <LI><B>TABLE_SCHEM</B> String => table schema (may be null)

   <LI><B>TABLE_NAME</B> String => table name

   <LI><B>COLUMN_NAME</B> String => column name

   <LI><B>DATA_TYPE</B> short => SQL type from java.sql.Types

   <LI><B>TYPE_NAME</B> String => Data source dependent type name,

   for a UDT the type name is fully qualified

   <LI><B>COLUMN_SIZE</B> int => column size.  For char or date

       types this is the maximum number of characters, for numeric or

       decimal types this is precision.

   <LI><B>BUFFER_LENGTH</B> is not used.

   <LI><B>DECIMAL_DIGITS</B> int => the number of fractional digits

   <LI><B>NUM_PREC_RADIX</B> int => Radix (typically either 10 or 2)

   <LI><B>NULLABLE</B> int => is NULL allowed?

       <UL>

       <LI> columnNoNulls - might not allow NULL values

       <LI> columnNullable - definitely allows NULL values

       <LI> columnNullableUnknown - nullability unknown

       </UL>

   <LI><B>REMARKS</B> String => comment describing column (may be null)

   <LI><B>COLUMN_DEF</B> String => default value (may be null)

   <LI><B>SQL_DATA_TYPE</B> int => unused

   <LI><B>SQL_DATETIME_SUB</B> int => unused

   <LI><B>CHAR_OCTET_LENGTH</B> int => for char types the

        maximum number of bytes in the column

   <LI><B>ORDINAL_POSITION</B> int => index of column in table

       (starting at 1)

   <LI><B>IS_NULLABLE</B> String => "NO" means column definitely

       does not allow NULL values; "YES" means the column might

       allow NULL values.  An empty string means nobody knows.

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schemaPattern a schema name pattern; "" retrieves those

  without a schema

  @param tableNamePattern a table name pattern

  @param columnNamePattern a column name pattern

  @return <code>ResultSet</code> - each row is a column description

  @see #getSearchStringEscape

}

function TZAbstractDatabaseMetadata.UncachedGetColumns(const Catalog: string;

  const SchemaPattern: string; const TableNamePattern: string;

  const ColumnNamePattern: string): IZResultSet;

begin

    Result := ConstructVirtualResultSet(TableColColumnsDynArray);

end;


{**

  Gets a description of the access rights for a table's columns.


  <P>Only privileges matching the column name criteria are

  returned.  They are ordered by COLUMN_NAME and PRIVILEGE.


  <P>Each privilige description has the following columns:

   <OL>

   <LI><B>TABLE_CAT</B> String => table catalog (may be null)

   <LI><B>TABLE_SCHEM</B> String => table schema (may be null)

   <LI><B>TABLE_NAME</B> String => table name

   <LI><B>COLUMN_NAME</B> String => column name

   <LI><B>GRANTOR</B> => grantor of access (may be null)

   <LI><B>GRANTEE</B> String => grantee of access

   <LI><B>PRIVILEGE</B> String => name of access (SELECT,

       INSERT, UPDATE, REFRENCES, ...)

   <LI><B>IS_GRANTABLE</B> String => "YES" if grantee is permitted

       to grant to others; "NO" if not; null if unknown

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schema a schema name; "" retrieves those without a schema

  @param table a table name

  @param columnNamePattern a column name pattern

  @return <code>ResultSet</code> - each row is a column privilege description

  @see #getSearchStringEscape

}

function TZAbstractDatabaseMetadata.GetColumnPrivileges(const Catalog: string;

  const Schema: string; const Table: string; const ColumnNamePattern: string): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(TableColPrivColumnsDynArray);

    exit;

  end;


  Key := GetColumnPrivilegesCacheKey(Catalog, Schema, Table,

    ColumnNamePattern);

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetColumnPrivileges(Catalog, Schema, Table, ColumnNamePattern);

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets a description of the access rights for a table's columns.


  <P>Only privileges matching the column name criteria are

  returned.  They are ordered by COLUMN_NAME and PRIVILEGE.


  <P>Each privilige description has the following columns:

   <OL>

   <LI><B>TABLE_CAT</B> String => table catalog (may be null)

   <LI><B>TABLE_SCHEM</B> String => table schema (may be null)

   <LI><B>TABLE_NAME</B> String => table name

   <LI><B>COLUMN_NAME</B> String => column name

   <LI><B>GRANTOR</B> => grantor of access (may be null)

   <LI><B>GRANTEE</B> String => grantee of access

   <LI><B>PRIVILEGE</B> String => name of access (SELECT,

       INSERT, UPDATE, REFRENCES, ...)

   <LI><B>IS_GRANTABLE</B> String => "YES" if grantee is permitted

       to grant to others; "NO" if not; null if unknown

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schema a schema name; "" retrieves those without a schema

  @param table a table name

  @param columnNamePattern a column name pattern

  @return <code>ResultSet</code> - each row is a column privilege description

  @see #getSearchStringEscape

}

function TZAbstractDatabaseMetadata.UncachedGetColumnPrivileges(const Catalog: string;

  const Schema: string; const Table: string; const ColumnNamePattern: string): IZResultSet;

begin

    Result := ConstructVirtualResultSet(TableColPrivColumnsDynArray);

end;


{**

  Gets a description of the access rights for each table available

  in a catalog. Note that a table privilege applies to one or

  more columns in the table. It would be wrong to assume that

  this priviledge applies to all columns (this may be true for

  some systems but is not true for all.)


  <P>Only privileges matching the schema and table name

  criteria are returned.  They are ordered by TABLE_SCHEM,

  TABLE_NAME, and PRIVILEGE.


  <P>Each privilige description has the following columns:

   <OL>

   <LI><B>TABLE_CAT</B> String => table catalog (may be null)

   <LI><B>TABLE_SCHEM</B> String => table schema (may be null)

   <LI><B>TABLE_NAME</B> String => table name

   <LI><B>GRANTOR</B> => grantor of access (may be null)

   <LI><B>GRANTEE</B> String => grantee of access

   <LI><B>PRIVILEGE</B> String => name of access (SELECT,

       INSERT, UPDATE, REFRENCES, ...)

   <LI><B>IS_GRANTABLE</B> String => "YES" if grantee is permitted

       to grant to others; "NO" if not; null if unknown

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schemaPattern a schema name pattern; "" retrieves those

  without a schema

  @param tableNamePattern a table name pattern

  @return <code>ResultSet</code> - each row is a table privilege description

  @see #getSearchStringEscape

}

function TZAbstractDatabaseMetadata.GetTablePrivileges(const Catalog: string;

  const SchemaPattern: string; const TableNamePattern: string): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(TablePrivColumnsDynArray);

    exit;

  end;


  Key := GetTablePrivilegesCacheKey(Catalog, SchemaPattern,

    TableNamePattern);

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetTablePrivileges(Catalog, SchemaPattern, TableNamePattern);

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets a description of the access rights for each table available

  in a catalog. Note that a table privilege applies to one or

  more columns in the table. It would be wrong to assume that

  this priviledge applies to all columns (this may be true for

  some systems but is not true for all.)


  <P>Only privileges matching the schema and table name

  criteria are returned.  They are ordered by TABLE_SCHEM,

  TABLE_NAME, and PRIVILEGE.


  <P>Each privilige description has the following columns:

   <OL>

   <LI><B>TABLE_CAT</B> String => table catalog (may be null)

   <LI><B>TABLE_SCHEM</B> String => table schema (may be null)

   <LI><B>TABLE_NAME</B> String => table name

   <LI><B>GRANTOR</B> => grantor of access (may be null)

   <LI><B>GRANTEE</B> String => grantee of access

   <LI><B>PRIVILEGE</B> String => name of access (SELECT,

       INSERT, UPDATE, REFRENCES, ...)

   <LI><B>IS_GRANTABLE</B> String => "YES" if grantee is permitted

       to grant to others; "NO" if not; null if unknown

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schemaPattern a schema name pattern; "" retrieves those

  without a schema

  @param tableNamePattern a table name pattern

  @return <code>ResultSet</code> - each row is a table privilege description

  @see #getSearchStringEscape

}

function TZAbstractDatabaseMetadata.UncachedGetTablePrivileges(const Catalog: string;

  const SchemaPattern: string; const TableNamePattern: string): IZResultSet;

begin

    Result := ConstructVirtualResultSet(TablePrivColumnsDynArray);

end;


{**

  Gets a description of a table's optimal set of columns that

  uniquely identifies a row. They are ordered by SCOPE.


  <P>Each column description has the following columns:

   <OL>

   <LI><B>SCOPE</B> short => actual scope of result

       <UL>

       <LI> bestRowTemporary - very temporary, while using row

       <LI> bestRowTransaction - valid for remainder of current transaction

       <LI> bestRowSession - valid for remainder of current session

       </UL>

   <LI><B>COLUMN_NAME</B> String => column name

   <LI><B>DATA_TYPE</B> short => SQL data type from java.sql.Types

   <LI><B>TYPE_NAME</B> String => Data source dependent type name,

   for a UDT the type name is fully qualified

   <LI><B>COLUMN_SIZE</B> int => precision

   <LI><B>BUFFER_LENGTH</B> int => not used

   <LI><B>DECIMAL_DIGITS</B> short  => scale

   <LI><B>PSEUDO_COLUMN</B> short => is this a pseudo column

       like an Oracle ROWID

       <UL>

       <LI> bestRowUnknown - may or may not be pseudo column

       <LI> bestRowNotPseudo - is NOT a pseudo column

       <LI> bestRowPseudo - is a pseudo column

       </UL>

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schema a schema name; "" retrieves those without a schema

  @param table a table name

  @param scope the scope of interest; use same values as SCOPE

  @param nullable include columns that are nullable?

  @return <code>ResultSet</code> - each row is a column description

}

function TZAbstractDatabaseMetadata.GetBestRowIdentifier(const Catalog: string;

  const Schema: string; const Table: string; Scope: Integer; Nullable: Boolean): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(BestRowIdentColumnsDynArray);

    exit;

  end;


  Key := GetBestRowIdentifierCacheKey(Catalog, Schema, Table, Scope,

    Nullable);

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetBestRowIdentifier(Catalog, Schema, Table, Scope, Nullable);

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets a description of a table's optimal set of columns that

  uniquely identifies a row. They are ordered by SCOPE.


  <P>Each column description has the following columns:

   <OL>

   <LI><B>SCOPE</B> short => actual scope of result

       <UL>

       <LI> bestRowTemporary - very temporary, while using row

       <LI> bestRowTransaction - valid for remainder of current transaction

       <LI> bestRowSession - valid for remainder of current session

       </UL>

   <LI><B>COLUMN_NAME</B> String => column name

   <LI><B>DATA_TYPE</B> short => SQL data type from java.sql.Types

   <LI><B>TYPE_NAME</B> String => Data source dependent type name,

   for a UDT the type name is fully qualified

   <LI><B>COLUMN_SIZE</B> int => precision

   <LI><B>BUFFER_LENGTH</B> int => not used

   <LI><B>DECIMAL_DIGITS</B> short  => scale

   <LI><B>PSEUDO_COLUMN</B> short => is this a pseudo column

       like an Oracle ROWID

       <UL>

       <LI> bestRowUnknown - may or may not be pseudo column

       <LI> bestRowNotPseudo - is NOT a pseudo column

       <LI> bestRowPseudo - is a pseudo column

       </UL>

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schema a schema name; "" retrieves those without a schema

  @param table a table name

  @param scope the scope of interest; use same values as SCOPE

  @param nullable include columns that are nullable?

  @return <code>ResultSet</code> - each row is a column description

}

function TZAbstractDatabaseMetadata.UncachedGetBestRowIdentifier(const Catalog: string;

  const Schema: string; const Table: string; Scope: Integer; Nullable: Boolean): IZResultSet;

var

  IndexName: string;

  ColumnNames: TStrings;

begin

    Result := ConstructVirtualResultSet(BestRowIdentColumnsDynArray);

    ColumnNames := TStringList.Create;

    try

      { Tries primary keys. }

      with GetPrimaryKeys(Catalog, Schema, Table) do

      begin

        while Next do

          ColumnNames.Add(GetStringByName('COLUMN_NAME'));

        Close;

      end;


      { Tries unique indices. }

      if ColumnNames.Count = 0 then

      begin

        with GetIndexInfo(Catalog, Schema, Table, True, False) do

        begin

          IndexName := '';

          while Next do

          begin

            if IndexName = '' then

              IndexName := GetStringByName('INDEX_NAME');

            if GetStringByName('INDEX_NAME') = IndexName then

              ColumnNames.Add(GetStringByName('COLUMN_NAME'));

          end;

          Close;

        end;

      end;


      with GetColumns(Catalog, Schema, Table, '') do

      begin

        while Next do

        begin

          if (ColumnNames.Count <> 0) and (ColumnNames.IndexOf(

            GetStringByName('COLUMN_NAME')) < 0) then

            Continue;

          if (ColumnNames.Count = 0)

            and (TZSQLType(GetIntByName('DATA_TYPE')) in

            [stBytes, stBinaryStream, stAsciiStream, stUnicodeStream]) then

            Continue;


          Result.MoveToInsertRow;

          Result.UpdateInt(1, Ord(sbrSession));

          Result.UpdateString(2, GetStringByName('COLUMN_NAME'));

          Result.UpdateInt(3, GetIntByName('DATA_TYPE'));

          Result.UpdateString(4, GetStringByName('TYPE_NAME'));

          Result.UpdateInt(5, GetIntByName('COLUMN_SIZE'));

          Result.UpdateInt(6, GetIntByName('BUFFER_LENGTH'));

          Result.UpdateInt(7, GetIntByName('DECIMAL_DIGITS'));

          Result.UpdateInt(8, Ord(brNotPseudo));

          Result.InsertRow;

        end;

        Close;

      end;

    finally

      ColumnNames.Free;

    end;

end;


{**

  Gets a description of a table's columns that are automatically

  updated when any value in a row is updated.  They are

  unordered.


  <P>Each column description has the following columns:

   <OL>

   <LI><B>SCOPE</B> short => is not used

   <LI><B>COLUMN_NAME</B> String => column name

   <LI><B>DATA_TYPE</B> short => SQL data type from java.sql.Types

   <LI><B>TYPE_NAME</B> String => Data source dependent type name

   <LI><B>COLUMN_SIZE</B> int => precision

   <LI><B>BUFFER_LENGTH</B> int => length of column value in bytes

   <LI><B>DECIMAL_DIGITS</B> short  => scale

   <LI><B>PSEUDO_COLUMN</B> short => is this a pseudo column

       like an Oracle ROWID

       <UL>

       <LI> versionColumnUnknown - may or may not be pseudo column

       <LI> versionColumnNotPseudo - is NOT a pseudo column

       <LI> versionColumnPseudo - is a pseudo column

       </UL>

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schema a schema name; "" retrieves those without a schema

  @param table a table name

  @return <code>ResultSet</code> - each row is a column description

  @exception SQLException if a database access error occurs

}


function TZAbstractDatabaseMetadata.GetVersionColumns(const Catalog: string;

  const Schema: string; const Table: string): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(TableColVerColumnsDynArray);

    exit;

  end;


  Key := GetVersionColumnsCacheKey(Catalog, Schema, Table);

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetVersionColumns(Catalog, Schema, Table);

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets a description of a table's columns that are automatically

  updated when any value in a row is updated.  They are

  unordered.


  <P>Each column description has the following columns:

   <OL>

   <LI><B>SCOPE</B> short => is not used

   <LI><B>COLUMN_NAME</B> String => column name

   <LI><B>DATA_TYPE</B> short => SQL data type from java.sql.Types

   <LI><B>TYPE_NAME</B> String => Data source dependent type name

   <LI><B>COLUMN_SIZE</B> int => precision

   <LI><B>BUFFER_LENGTH</B> int => length of column value in bytes

   <LI><B>DECIMAL_DIGITS</B> short  => scale

   <LI><B>PSEUDO_COLUMN</B> short => is this a pseudo column

       like an Oracle ROWID

       <UL>

       <LI> versionColumnUnknown - may or may not be pseudo column

       <LI> versionColumnNotPseudo - is NOT a pseudo column

       <LI> versionColumnPseudo - is a pseudo column

       </UL>

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schema a schema name; "" retrieves those without a schema

  @param table a table name

  @return <code>ResultSet</code> - each row is a column description

  @exception SQLException if a database access error occurs

}

function TZAbstractDatabaseMetadata.UncachedGetVersionColumns(const Catalog: string;

  const Schema: string; const Table: string): IZResultSet;

begin

    Result := ConstructVirtualResultSet(TableColVerColumnsDynArray);

end;


{**

  Gets a description of a table's primary key columns.  They

  are ordered by COLUMN_NAME.


  <P>Each primary key column description has the following columns:

   <OL>

   <LI><B>TABLE_CAT</B> String => table catalog (may be null)

   <LI><B>TABLE_SCHEM</B> String => table schema (may be null)

   <LI><B>TABLE_NAME</B> String => table name

   <LI><B>COLUMN_NAME</B> String => column name

   <LI><B>KEY_SEQ</B> short => sequence number within primary key

   <LI><B>PK_NAME</B> String => primary key name (may be null)

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schema a schema name; "" retrieves those

  without a schema

  @param table a table name

  @return <code>ResultSet</code> - each row is a primary key column description

  @exception SQLException if a database access error occurs

}

function TZAbstractDatabaseMetadata.GetPrimaryKeys(const Catalog: string;

  const Schema: string; const Table: string): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(PrimaryKeyColumnsDynArray);

    exit;

  end;


  Key := GetPrimaryKeysCacheKey(Catalog, Schema, Table);

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetPrimaryKeys(Catalog, Schema, Table);

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets a description of a table's primary key columns.  They

  are ordered by COLUMN_NAME.


  <P>Each primary key column description has the following columns:

   <OL>

   <LI><B>TABLE_CAT</B> String => table catalog (may be null)

   <LI><B>TABLE_SCHEM</B> String => table schema (may be null)

   <LI><B>TABLE_NAME</B> String => table name

   <LI><B>COLUMN_NAME</B> String => column name

   <LI><B>KEY_SEQ</B> short => sequence number within primary key

   <LI><B>PK_NAME</B> String => primary key name (may be null)

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schema a schema name; "" retrieves those

  without a schema

  @param table a table name

  @return <code>ResultSet</code> - each row is a primary key column description

  @exception SQLException if a database access error occurs

}

function TZAbstractDatabaseMetadata.UncachedGetPrimaryKeys(const Catalog: string;

  const Schema: string; const Table: string): IZResultSet;

begin

    Result := ConstructVirtualResultSet(PrimaryKeyColumnsDynArray);

end;


{**

  Gets a description of the primary key columns that are

  referenced by a table's foreign key columns (the primary keys

  imported by a table).  They are ordered by PKTABLE_CAT,

  PKTABLE_SCHEM, PKTABLE_NAME, and KEY_SEQ.


  <P>Each primary key column description has the following columns:

   <OL>

   <LI><B>PKTABLE_CAT</B> String => primary key table catalog

       being imported (may be null)

   <LI><B>PKTABLE_SCHEM</B> String => primary key table schema

       being imported (may be null)

   <LI><B>PKTABLE_NAME</B> String => primary key table name

       being imported

   <LI><B>PKCOLUMN_NAME</B> String => primary key column name

       being imported

   <LI><B>FKTABLE_CAT</B> String => foreign key table catalog (may be null)

   <LI><B>FKTABLE_SCHEM</B> String => foreign key table schema (may be null)

   <LI><B>FKTABLE_NAME</B> String => foreign key table name

   <LI><B>FKCOLUMN_NAME</B> String => foreign key column name

   <LI><B>KEY_SEQ</B> short => sequence number within foreign key

   <LI><B>UPDATE_RULE</B> short => What happens to

        foreign key when primary is updated:

       <UL>

       <LI> importedNoAction - do not allow update of primary

                key if it has been imported

       <LI> importedKeyCascade - change imported key to agree

                with primary key update

       <LI> importedKeySetNull - change imported key to NULL if

                its primary key has been updated

       <LI> importedKeySetDefault - change imported key to default values

                if its primary key has been updated

       <LI> importedKeyRestrict - same as importedKeyNoAction

                                  (for ODBC 2.x compatibility)

       </UL>

   <LI><B>DELETE_RULE</B> short => What happens to

       the foreign key when primary is deleted.

       <UL>

       <LI> importedKeyNoAction - do not allow delete of primary

                key if it has been imported

       <LI> importedKeyCascade - delete rows that import a deleted key

       <LI> importedKeySetNull - change imported key to NULL if

                its primary key has been deleted

       <LI> importedKeyRestrict - same as importedKeyNoAction

                                  (for ODBC 2.x compatibility)

       <LI> importedKeySetDefault - change imported key to default if

                its primary key has been deleted

       </UL>

   <LI><B>FK_NAME</B> String => foreign key name (may be null)

   <LI><B>PK_NAME</B> String => primary key name (may be null)

   <LI><B>DEFERRABILITY</B> short => can the evaluation of foreign key

       constraints be deferred until commit

       <UL>

       <LI> importedKeyInitiallyDeferred - see SQL92 for definition

       <LI> importedKeyInitiallyImmediate - see SQL92 for definition

       <LI> importedKeyNotDeferrable - see SQL92 for definition

       </UL>

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schema a schema name; "" retrieves those

  without a schema

  @param table a table name

  @return <code>ResultSet</code> - each row is a primary key column description

  @see #getExportedKeys

}

function TZAbstractDatabaseMetadata.GetImportedKeys(const Catalog: string;

  const Schema: string; const Table: string): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(ImportedKeyColumnsDynArray);

    exit;

  end;


  Key := GetImportedKeysCacheKey(Catalog, Schema, Table);

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetImportedKeys(Catalog, Schema, Table);

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets a description of the primary key columns that are

  referenced by a table's foreign key columns (the primary keys

  imported by a table).  They are ordered by PKTABLE_CAT,

  PKTABLE_SCHEM, PKTABLE_NAME, and KEY_SEQ.


  <P>Each primary key column description has the following columns:

   <OL>

   <LI><B>PKTABLE_CAT</B> String => primary key table catalog

       being imported (may be null)

   <LI><B>PKTABLE_SCHEM</B> String => primary key table schema

       being imported (may be null)

   <LI><B>PKTABLE_NAME</B> String => primary key table name

       being imported

   <LI><B>PKCOLUMN_NAME</B> String => primary key column name

       being imported

   <LI><B>FKTABLE_CAT</B> String => foreign key table catalog (may be null)

   <LI><B>FKTABLE_SCHEM</B> String => foreign key table schema (may be null)

   <LI><B>FKTABLE_NAME</B> String => foreign key table name

   <LI><B>FKCOLUMN_NAME</B> String => foreign key column name

   <LI><B>KEY_SEQ</B> short => sequence number within foreign key

   <LI><B>UPDATE_RULE</B> short => What happens to

        foreign key when primary is updated:

       <UL>

       <LI> importedNoAction - do not allow update of primary

                key if it has been imported

       <LI> importedKeyCascade - change imported key to agree

                with primary key update

       <LI> importedKeySetNull - change imported key to NULL if

                its primary key has been updated

       <LI> importedKeySetDefault - change imported key to default values

                if its primary key has been updated

       <LI> importedKeyRestrict - same as importedKeyNoAction

                                  (for ODBC 2.x compatibility)

       </UL>

   <LI><B>DELETE_RULE</B> short => What happens to

       the foreign key when primary is deleted.

       <UL>

       <LI> importedKeyNoAction - do not allow delete of primary

                key if it has been imported

       <LI> importedKeyCascade - delete rows that import a deleted key

       <LI> importedKeySetNull - change imported key to NULL if

                its primary key has been deleted

       <LI> importedKeyRestrict - same as importedKeyNoAction

                                  (for ODBC 2.x compatibility)

       <LI> importedKeySetDefault - change imported key to default if

                its primary key has been deleted

       </UL>

   <LI><B>FK_NAME</B> String => foreign key name (may be null)

   <LI><B>PK_NAME</B> String => primary key name (may be null)

   <LI><B>DEFERRABILITY</B> short => can the evaluation of foreign key

       constraints be deferred until commit

       <UL>

       <LI> importedKeyInitiallyDeferred - see SQL92 for definition

       <LI> importedKeyInitiallyImmediate - see SQL92 for definition

       <LI> importedKeyNotDeferrable - see SQL92 for definition

       </UL>

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schema a schema name; "" retrieves those

  without a schema

  @param table a table name

  @return <code>ResultSet</code> - each row is a primary key column description

  @see #getExportedKeys

}

function TZAbstractDatabaseMetadata.UncachedGetImportedKeys(const Catalog: string;

  const Schema: string; const Table: string): IZResultSet;

begin

    Result := ConstructVirtualResultSet(ImportedKeyColumnsDynArray);

end;


{**

  Gets a description of the foreign key columns that reference a

  table's primary key columns (the foreign keys exported by a

  table).  They are ordered by FKTABLE_CAT, FKTABLE_SCHEM,

  FKTABLE_NAME, and KEY_SEQ.


  <P>Each foreign key column description has the following columns:

   <OL>

   <LI><B>PKTABLE_CAT</B> String => primary key table catalog (may be null)

   <LI><B>PKTABLE_SCHEM</B> String => primary key table schema (may be null)

   <LI><B>PKTABLE_NAME</B> String => primary key table name

   <LI><B>PKCOLUMN_NAME</B> String => primary key column name

   <LI><B>FKTABLE_CAT</B> String => foreign key table catalog (may be null)

       being exported (may be null)

   <LI><B>FKTABLE_SCHEM</B> String => foreign key table schema (may be null)

       being exported (may be null)

   <LI><B>FKTABLE_NAME</B> String => foreign key table name

       being exported

   <LI><B>FKCOLUMN_NAME</B> String => foreign key column name

       being exported

   <LI><B>KEY_SEQ</B> short => sequence number within foreign key

   <LI><B>UPDATE_RULE</B> short => What happens to

        foreign key when primary is updated:

       <UL>

       <LI> importedNoAction - do not allow update of primary

                key if it has been imported

       <LI> importedKeyCascade - change imported key to agree

                with primary key update

       <LI> importedKeySetNull - change imported key to NULL if

                its primary key has been updated

       <LI> importedKeySetDefault - change imported key to default values

                if its primary key has been updated

       <LI> importedKeyRestrict - same as importedKeyNoAction

                                  (for ODBC 2.x compatibility)

       </UL>

   <LI><B>DELETE_RULE</B> short => What happens to

       the foreign key when primary is deleted.

       <UL>

       <LI> importedKeyNoAction - do not allow delete of primary

                key if it has been imported

       <LI> importedKeyCascade - delete rows that import a deleted key

       <LI> importedKeySetNull - change imported key to NULL if

                its primary key has been deleted

       <LI> importedKeyRestrict - same as importedKeyNoAction

                                  (for ODBC 2.x compatibility)

       <LI> importedKeySetDefault - change imported key to default if

                its primary key has been deleted

       </UL>

   <LI><B>FK_NAME</B> String => foreign key name (may be null)

   <LI><B>PK_NAME</B> String => primary key name (may be null)

   <LI><B>DEFERRABILITY</B> short => can the evaluation of foreign key

       constraints be deferred until commit

       <UL>

       <LI> importedKeyInitiallyDeferred - see SQL92 for definition

       <LI> importedKeyInitiallyImmediate - see SQL92 for definition

       <LI> importedKeyNotDeferrable - see SQL92 for definition

       </UL>

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schema a schema name; "" retrieves those

  without a schema

  @param table a table name

  @return <code>ResultSet</code> - each row is a foreign key column description

  @see #getImportedKeys

}

function TZAbstractDatabaseMetadata.GetExportedKeys(const Catalog: string;

  const Schema: string; const Table: string): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(ExportedKeyColumnsDynArray);

    exit;

  end;


  Key := GetExportedKeysCacheKey(Catalog, Schema, Table);

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetExportedKeys(Catalog, Schema, Table);

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets a description of the foreign key columns that reference a

  table's primary key columns (the foreign keys exported by a

  table).  They are ordered by FKTABLE_CAT, FKTABLE_SCHEM,

  FKTABLE_NAME, and KEY_SEQ.


  <P>Each foreign key column description has the following columns:

   <OL>

   <LI><B>PKTABLE_CAT</B> String => primary key table catalog (may be null)

   <LI><B>PKTABLE_SCHEM</B> String => primary key table schema (may be null)

   <LI><B>PKTABLE_NAME</B> String => primary key table name

   <LI><B>PKCOLUMN_NAME</B> String => primary key column name

   <LI><B>FKTABLE_CAT</B> String => foreign key table catalog (may be null)

       being exported (may be null)

   <LI><B>FKTABLE_SCHEM</B> String => foreign key table schema (may be null)

       being exported (may be null)

   <LI><B>FKTABLE_NAME</B> String => foreign key table name

       being exported

   <LI><B>FKCOLUMN_NAME</B> String => foreign key column name

       being exported

   <LI><B>KEY_SEQ</B> short => sequence number within foreign key

   <LI><B>UPDATE_RULE</B> short => What happens to

        foreign key when primary is updated:

       <UL>

       <LI> importedNoAction - do not allow update of primary

                key if it has been imported

       <LI> importedKeyCascade - change imported key to agree

                with primary key update

       <LI> importedKeySetNull - change imported key to NULL if

                its primary key has been updated

       <LI> importedKeySetDefault - change imported key to default values

                if its primary key has been updated

       <LI> importedKeyRestrict - same as importedKeyNoAction

                                  (for ODBC 2.x compatibility)

       </UL>

   <LI><B>DELETE_RULE</B> short => What happens to

       the foreign key when primary is deleted.

       <UL>

       <LI> importedKeyNoAction - do not allow delete of primary

                key if it has been imported

       <LI> importedKeyCascade - delete rows that import a deleted key

       <LI> importedKeySetNull - change imported key to NULL if

                its primary key has been deleted

       <LI> importedKeyRestrict - same as importedKeyNoAction

                                  (for ODBC 2.x compatibility)

       <LI> importedKeySetDefault - change imported key to default if

                its primary key has been deleted

       </UL>

   <LI><B>FK_NAME</B> String => foreign key name (may be null)

   <LI><B>PK_NAME</B> String => primary key name (may be null)

   <LI><B>DEFERRABILITY</B> short => can the evaluation of foreign key

       constraints be deferred until commit

       <UL>

       <LI> importedKeyInitiallyDeferred - see SQL92 for definition

       <LI> importedKeyInitiallyImmediate - see SQL92 for definition

       <LI> importedKeyNotDeferrable - see SQL92 for definition

       </UL>

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schema a schema name; "" retrieves those

  without a schema

  @param table a table name

  @return <code>ResultSet</code> - each row is a foreign key column description

  @see #getImportedKeys

}

function TZAbstractDatabaseMetadata.UncachedGetExportedKeys(const Catalog: string;

  const Schema: string; const Table: string): IZResultSet;

begin

    Result := ConstructVirtualResultSet(ExportedKeyColumnsDynArray);

end;


{**

  Gets a description of the foreign key columns in the foreign key

  table that reference the primary key columns of the primary key

  table (describe how one table imports another's key.) This

  should normally return a single foreign key/primary key pair

  (most tables only import a foreign key from a table once.)  They

  are ordered by FKTABLE_CAT, FKTABLE_SCHEM, FKTABLE_NAME, and

  KEY_SEQ.


  <P>Each foreign key column description has the following columns:

   <OL>

   <LI><B>PKTABLE_CAT</B> String => primary key table catalog (may be null)

   <LI><B>PKTABLE_SCHEM</B> String => primary key table schema (may be null)

   <LI><B>PKTABLE_NAME</B> String => primary key table name

   <LI><B>PKCOLUMN_NAME</B> String => primary key column name

   <LI><B>FKTABLE_CAT</B> String => foreign key table catalog (may be null)

       being exported (may be null)

   <LI><B>FKTABLE_SCHEM</B> String => foreign key table schema (may be null)

       being exported (may be null)

   <LI><B>FKTABLE_NAME</B> String => foreign key table name

       being exported

   <LI><B>FKCOLUMN_NAME</B> String => foreign key column name

       being exported

   <LI><B>KEY_SEQ</B> short => sequence number within foreign key

   <LI><B>UPDATE_RULE</B> short => What happens to

        foreign key when primary is updated:

       <UL>

       <LI> importedNoAction - do not allow update of primary

                key if it has been imported

       <LI> importedKeyCascade - change imported key to agree

                with primary key update

       <LI> importedKeySetNull - change imported key to NULL if

                its primary key has been updated

       <LI> importedKeySetDefault - change imported key to default values

                if its primary key has been updated

       <LI> importedKeyRestrict - same as importedKeyNoAction

                                  (for ODBC 2.x compatibility)

       </UL>

   <LI><B>DELETE_RULE</B> short => What happens to

       the foreign key when primary is deleted.

       <UL>

       <LI> importedKeyNoAction - do not allow delete of primary

                key if it has been imported

       <LI> importedKeyCascade - delete rows that import a deleted key

       <LI> importedKeySetNull - change imported key to NULL if

                its primary key has been deleted

       <LI> importedKeyRestrict - same as importedKeyNoAction

                                  (for ODBC 2.x compatibility)

       <LI> importedKeySetDefault - change imported key to default if

                its primary key has been deleted

       </UL>

   <LI><B>FK_NAME</B> String => foreign key name (may be null)

   <LI><B>PK_NAME</B> String => primary key name (may be null)

   <LI><B>DEFERRABILITY</B> short => can the evaluation of foreign key

       constraints be deferred until commit

       <UL>

       <LI> importedKeyInitiallyDeferred - see SQL92 for definition

       <LI> importedKeyInitiallyImmediate - see SQL92 for definition

       <LI> importedKeyNotDeferrable - see SQL92 for definition

       </UL>

   </OL>


  @param primaryCatalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param primarySchema a schema name; "" retrieves those

  without a schema

  @param primaryTable the table name that exports the key

  @param foreignCatalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param foreignSchema a schema name; "" retrieves those

  without a schema

  @param foreignTable the table name that imports the key

  @return <code>ResultSet</code> - each row is a foreign key column description

  @see #getImportedKeys

}

function TZAbstractDatabaseMetadata.GetCrossReference(const PrimaryCatalog: string;

  const PrimarySchema: string; const PrimaryTable: string; const ForeignCatalog: string;

  const ForeignSchema: string; const ForeignTable: string): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(CrossRefColumnsDynArray);

    exit;

  end;


  Key := GetCrossReferenceCacheKey(PrimaryCatalog, PrimarySchema, PrimaryTable,

    ForeignCatalog, ForeignSchema, ForeignTable);


  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetCrossReference(PrimaryCatalog, PrimarySchema, PrimaryTable,

    ForeignCatalog, ForeignSchema, ForeignTable);

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets a description of the foreign key columns in the foreign key

  table that reference the primary key columns of the primary key

  table (describe how one table imports another's key.) This

  should normally return a single foreign key/primary key pair

  (most tables only import a foreign key from a table once.)  They

  are ordered by FKTABLE_CAT, FKTABLE_SCHEM, FKTABLE_NAME, and

  KEY_SEQ.


  <P>Each foreign key column description has the following columns:

   <OL>

   <LI><B>PKTABLE_CAT</B> String => primary key table catalog (may be null)

   <LI><B>PKTABLE_SCHEM</B> String => primary key table schema (may be null)

   <LI><B>PKTABLE_NAME</B> String => primary key table name

   <LI><B>PKCOLUMN_NAME</B> String => primary key column name

   <LI><B>FKTABLE_CAT</B> String => foreign key table catalog (may be null)

       being exported (may be null)

   <LI><B>FKTABLE_SCHEM</B> String => foreign key table schema (may be null)

       being exported (may be null)

   <LI><B>FKTABLE_NAME</B> String => foreign key table name

       being exported

   <LI><B>FKCOLUMN_NAME</B> String => foreign key column name

       being exported

   <LI><B>KEY_SEQ</B> short => sequence number within foreign key

   <LI><B>UPDATE_RULE</B> short => What happens to

        foreign key when primary is updated:

       <UL>

       <LI> importedNoAction - do not allow update of primary

                key if it has been imported

       <LI> importedKeyCascade - change imported key to agree

                with primary key update

       <LI> importedKeySetNull - change imported key to NULL if

                its primary key has been updated

       <LI> importedKeySetDefault - change imported key to default values

                if its primary key has been updated

       <LI> importedKeyRestrict - same as importedKeyNoAction

                                  (for ODBC 2.x compatibility)

       </UL>

   <LI><B>DELETE_RULE</B> short => What happens to

       the foreign key when primary is deleted.

       <UL>

       <LI> importedKeyNoAction - do not allow delete of primary

                key if it has been imported

       <LI> importedKeyCascade - delete rows that import a deleted key

       <LI> importedKeySetNull - change imported key to NULL if

                its primary key has been deleted

       <LI> importedKeyRestrict - same as importedKeyNoAction

                                  (for ODBC 2.x compatibility)

       <LI> importedKeySetDefault - change imported key to default if

                its primary key has been deleted

       </UL>

   <LI><B>FK_NAME</B> String => foreign key name (may be null)

   <LI><B>PK_NAME</B> String => primary key name (may be null)

   <LI><B>DEFERRABILITY</B> short => can the evaluation of foreign key

       constraints be deferred until commit

       <UL>

       <LI> importedKeyInitiallyDeferred - see SQL92 for definition

       <LI> importedKeyInitiallyImmediate - see SQL92 for definition

       <LI> importedKeyNotDeferrable - see SQL92 for definition

       </UL>

   </OL>


  @param primaryCatalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param primarySchema a schema name; "" retrieves those

  without a schema

  @param primaryTable the table name that exports the key

  @param foreignCatalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param foreignSchema a schema name; "" retrieves those

  without a schema

  @param foreignTable the table name that imports the key

  @return <code>ResultSet</code> - each row is a foreign key column description

  @see #getImportedKeys

}

function TZAbstractDatabaseMetadata.UncachedGetCrossReference(const PrimaryCatalog: string;

  const PrimarySchema: string; const PrimaryTable: string; const ForeignCatalog: string;

  const ForeignSchema: string; const ForeignTable: string): IZResultSet;

begin

    Result := ConstructVirtualResultSet(CrossRefColumnsDynArray);

end;


{**

  Gets a description of all the standard SQL types supported by

  this database. They are ordered by DATA_TYPE and then by how

  closely the data type maps to the corresponding JDBC SQL type.


  <P>Each type description has the following columns:

   <OL>

   <LI><B>TYPE_NAME</B> String => Type name

   <LI><B>DATA_TYPE</B> short => SQL data type from java.sql.Types

   <LI><B>PRECISION</B> int => maximum precision

   <LI><B>LITERAL_PREFIX</B> String => prefix used to quote a literal

       (may be null)

   <LI><B>LITERAL_SUFFIX</B> String => suffix used to quote a literal

        (may be null)

   <LI><B>CREATE_PARAMS</B> String => parameters used in creating

       the type (may be null)

   <LI><B>NULLABLE</B> short => can you use NULL for this type?

       <UL>

       <LI> typeNoNulls - does not allow NULL values

       <LI> typeNullable - allows NULL values

       <LI> typeNullableUnknown - nullability unknown

       </UL>

   <LI><B>CASE_SENSITIVE</B> boolean=> is it case sensitive?

   <LI><B>SEARCHABLE</B> short => can you use "WHERE" based on this type:

       <UL>

       <LI> typePredNone - No support

       <LI> typePredChar - Only supported with WHERE .. LIKE

       <LI> typePredBasic - Supported except for WHERE .. LIKE

       <LI> typeSearchable - Supported for all WHERE ..

       </UL>

   <LI><B>UNSIGNED_ATTRIBUTE</B> boolean => is it unsigned?

   <LI><B>FIXED_PREC_SCALE</B> boolean => can it be a money value?

   <LI><B>AUTO_INCREMENT</B> boolean => can it be used for an

       auto-increment value?

   <LI><B>LOCAL_TYPE_NAME</B> String => localized version of type name

       (may be null)

   <LI><B>MINIMUM_SCALE</B> short => minimum scale supported

   <LI><B>MAXIMUM_SCALE</B> short => maximum scale supported

   <LI><B>SQL_DATA_TYPE</B> int => unused

   <LI><B>SQL_DATETIME_SUB</B> int => unused

   <LI><B>NUM_PREC_RADIX</B> int => usually 2 or 10

   </OL>


  @return <code>ResultSet</code> - each row is an SQL type description

}

function TZAbstractDatabaseMetadata.GetTypeInfo: IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(TypeInfoColumnsDynArray);

    exit;

  end;


  Key := GetTypeInfoCacheKey;

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetTypeInfo;

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets a description of all the standard SQL types supported by

  this database. They are ordered by DATA_TYPE and then by how

  closely the data type maps to the corresponding JDBC SQL type.


  <P>Each type description has the following columns:

   <OL>

   <LI><B>TYPE_NAME</B> String => Type name

   <LI><B>DATA_TYPE</B> short => SQL data type from java.sql.Types

   <LI><B>PRECISION</B> int => maximum precision

   <LI><B>LITERAL_PREFIX</B> String => prefix used to quote a literal

       (may be null)

   <LI><B>LITERAL_SUFFIX</B> String => suffix used to quote a literal

        (may be null)

   <LI><B>CREATE_PARAMS</B> String => parameters used in creating

       the type (may be null)

   <LI><B>NULLABLE</B> short => can you use NULL for this type?

       <UL>

       <LI> typeNoNulls - does not allow NULL values

       <LI> typeNullable - allows NULL values

       <LI> typeNullableUnknown - nullability unknown

       </UL>

   <LI><B>CASE_SENSITIVE</B> boolean=> is it case sensitive?

   <LI><B>SEARCHABLE</B> short => can you use "WHERE" based on this type:

       <UL>

       <LI> typePredNone - No support

       <LI> typePredChar - Only supported with WHERE .. LIKE

       <LI> typePredBasic - Supported except for WHERE .. LIKE

       <LI> typeSearchable - Supported for all WHERE ..

       </UL>

   <LI><B>UNSIGNED_ATTRIBUTE</B> boolean => is it unsigned?

   <LI><B>FIXED_PREC_SCALE</B> boolean => can it be a money value?

   <LI><B>AUTO_INCREMENT</B> boolean => can it be used for an

       auto-increment value?

   <LI><B>LOCAL_TYPE_NAME</B> String => localized version of type name

       (may be null)

   <LI><B>MINIMUM_SCALE</B> short => minimum scale supported

   <LI><B>MAXIMUM_SCALE</B> short => maximum scale supported

   <LI><B>SQL_DATA_TYPE</B> int => unused

   <LI><B>SQL_DATETIME_SUB</B> int => unused

   <LI><B>NUM_PREC_RADIX</B> int => usually 2 or 10

   </OL>


  @return <code>ResultSet</code> - each row is an SQL type description

}

function TZAbstractDatabaseMetadata.UncachedGetTypeInfo: IZResultSet;

begin

    Result := ConstructVirtualResultSet(TypeInfoColumnsDynArray);

end;


{**

  Gets a description of a table's indices and statistics. They are

  ordered by NON_UNIQUE, TYPE, INDEX_NAME, and ORDINAL_POSITION.


  <P>Each index column description has the following columns:

   <OL>

   <LI><B>TABLE_CAT</B> String => table catalog (may be null)

   <LI><B>TABLE_SCHEM</B> String => table schema (may be null)

   <LI><B>TABLE_NAME</B> String => table name

   <LI><B>NON_UNIQUE</B> boolean => Can index values be non-unique?

       false when TYPE is tableIndexStatistic

   <LI><B>INDEX_QUALIFIER</B> String => index catalog (may be null);

       null when TYPE is tableIndexStatistic

   <LI><B>INDEX_NAME</B> String => index name; null when TYPE is

       tableIndexStatistic

   <LI><B>TYPE</B> short => index type:

       <UL>

       <LI> tableIndexStatistic - this identifies table statistics that are

            returned in conjuction with a table's index descriptions

       <LI> tableIndexClustered - this is a clustered index

       <LI> tableIndexHashed - this is a hashed index

       <LI> tableIndexOther - this is some other style of index

       </UL>

   <LI><B>ORDINAL_POSITION</B> short => column sequence number

       within index; zero when TYPE is tableIndexStatistic

   <LI><B>COLUMN_NAME</B> String => column name; null when TYPE is

       tableIndexStatistic

   <LI><B>ASC_OR_DESC</B> String => column sort sequence, "A" => ascending,

       "D" => descending, may be null if sort sequence is not supported;

       null when TYPE is tableIndexStatistic

   <LI><B>CARDINALITY</B> int => When TYPE is tableIndexStatistic, then

       this is the number of rows in the table; otherwise, it is the

       number of unique values in the index.

   <LI><B>PAGES</B> int => When TYPE is  tableIndexStatisic then

       this is the number of pages used for the table, otherwise it

       is the number of pages used for the current index.

   <LI><B>FILTER_CONDITION</B> String => Filter condition, if any.

       (may be null)

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schema a schema name; "" retrieves those without a schema

  @param table a table name

  @param unique when true, return only indices for unique values;

      when false, return indices regardless of whether unique or not

  @param approximate when true, result is allowed to reflect approximate

      or out of data values; when false, results are requested to be

      accurate

  @return <code>ResultSet</code> - each row is an index column description

}

function TZAbstractDatabaseMetadata.GetIndexInfo(const Catalog: string;

  const Schema: string; const Table: string; Unique: Boolean;

  Approximate: Boolean): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(IndexInfoColumnsDynArray);

    exit;

  end;


  Key := GetIndexInfoCacheKey(Catalog, Schema, Table, Unique, Approximate);


  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetIndexInfo(Catalog, Schema, Table, Unique, Approximate);

    AddResultSetToCache(Key, Result);

  end;

end;


{**

  Gets a description of a table's indices and statistics. They are

  ordered by NON_UNIQUE, TYPE, INDEX_NAME, and ORDINAL_POSITION.


  <P>Each index column description has the following columns:

   <OL>

   <LI><B>TABLE_CAT</B> String => table catalog (may be null)

   <LI><B>TABLE_SCHEM</B> String => table schema (may be null)

   <LI><B>TABLE_NAME</B> String => table name

   <LI><B>NON_UNIQUE</B> boolean => Can index values be non-unique?

       false when TYPE is tableIndexStatistic

   <LI><B>INDEX_QUALIFIER</B> String => index catalog (may be null);

       null when TYPE is tableIndexStatistic

   <LI><B>INDEX_NAME</B> String => index name; null when TYPE is

       tableIndexStatistic

   <LI><B>TYPE</B> short => index type:

       <UL>

       <LI> tableIndexStatistic - this identifies table statistics that are

            returned in conjuction with a table's index descriptions

       <LI> tableIndexClustered - this is a clustered index

       <LI> tableIndexHashed - this is a hashed index

       <LI> tableIndexOther - this is some other style of index

       </UL>

   <LI><B>ORDINAL_POSITION</B> short => column sequence number

       within index; zero when TYPE is tableIndexStatistic

   <LI><B>COLUMN_NAME</B> String => column name; null when TYPE is

       tableIndexStatistic

   <LI><B>ASC_OR_DESC</B> String => column sort sequence, "A" => ascending,

       "D" => descending, may be null if sort sequence is not supported;

       null when TYPE is tableIndexStatistic

   <LI><B>CARDINALITY</B> int => When TYPE is tableIndexStatistic, then

       this is the number of rows in the table; otherwise, it is the

       number of unique values in the index.

   <LI><B>PAGES</B> int => When TYPE is  tableIndexStatisic then

       this is the number of pages used for the table, otherwise it

       is the number of pages used for the current index.

   <LI><B>FILTER_CONDITION</B> String => Filter condition, if any.

       (may be null)

   </OL>


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schema a schema name; "" retrieves those without a schema

  @param table a table name

  @param unique when true, return only indices for unique values;

      when false, return indices regardless of whether unique or not

  @param approximate when true, result is allowed to reflect approximate

      or out of data values; when false, results are requested to be

      accurate

  @return <code>ResultSet</code> - each row is an index column description

}

function TZAbstractDatabaseMetadata.UncachedGetIndexInfo(const Catalog: string;

  const Schema: string; const Table: string; Unique: Boolean;

  Approximate: Boolean): IZResultSet;

begin

    Result := ConstructVirtualResultSet(IndexInfoColumnsDynArray);

end;


function TZAbstractDatabaseMetadata.GetSequences(const Catalog: string;

  const SchemaPattern: string; const SequenceNamePattern: string): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(SequenceColumnsDynArray);

    exit;

  end;


  Key := GetSequencesCacheKey(Catalog, SchemaPattern, SequenceNamePattern);

  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetSequences(Catalog, SchemaPattern, SequenceNamePattern);

    AddResultSetToCache(Key, Result);

  end;

end;


function TZAbstractDatabaseMetadata.UncachedGetSequences(const Catalog: string;

  const SchemaPattern: string; const SequenceNamePattern: string): IZResultSet;

begin

    Result := ConstructVirtualResultSet(SequenceColumnsDynArray);

end;


{**


  Gets a description of the user-defined types defined in a particular

  schema.  Schema-specific UDTs may have type JAVA_OBJECT, STRUCT,

  or DISTINCT.


  <P>Only types matching the catalog, schema, type name and type

  criteria are returned.  They are ordered by DATA_TYPE, TYPE_SCHEM

  and TYPE_NAME.  The type name parameter may be a fully-qualified

  name.  In this case, the catalog and schemaPattern parameters are

  ignored.


  <P>Each type description has the following columns:

   <OL>

   <LI><B>TYPE_CAT</B> String => the type's catalog (may be null)

   <LI><B>TYPE_SCHEM</B> String => type's schema (may be null)

   <LI><B>TYPE_NAME</B> String => type name

   <LI><B>CLASS_NAME</B> String => Java class name

   <LI><B>DATA_TYPE</B> String => type value defined in java.sql.Types.

   One of JAVA_OBJECT, STRUCT, or DISTINCT

   <LI><B>REMARKS</B> String => explanatory comment on the type

   </OL>


  <P><B>Note:</B> If the driver does not support UDTs, an empty

  result set is returned.


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schemaPattern a schema name pattern; "" retrieves those

  without a schema

  @param typeNamePattern a type name pattern; may be a fully-qualified name

  @param types a list of user-named types to include (JAVA_OBJECT,

  STRUCT, or DISTINCT); null returns all types

  @return <code>ResultSet</code> - each row is a type description

}

function TZAbstractDatabaseMetadata.GetUDTs(const Catalog: string;

  const SchemaPattern: string; const TypeNamePattern: string;

  const Types: TIntegerDynArray): IZResultSet;

var

  Key: string;

begin

  if not GetConnection.UseMetadata then

  begin

    Result := ConstructVirtualResultSet(UDTColumnsDynArray);

    exit;

  end;


  Key := GetUDTsCacheKey(Catalog, SchemaPattern, TypeNamePattern,

    Types);


  Result := GetResultSetFromCache(Key);

  if Result = nil then

  begin

    Result := UncachedGetUDTs(Catalog, SchemaPattern, TypeNamePattern, Types);

    AddResultSetToCache(Key, Result);

  end;

end;


{**


  Gets a description of the user-defined types defined in a particular

  schema.  Schema-specific UDTs may have type JAVA_OBJECT, STRUCT,

  or DISTINCT.


  <P>Only types matching the catalog, schema, type name and type

  criteria are returned.  They are ordered by DATA_TYPE, TYPE_SCHEM

  and TYPE_NAME.  The type name parameter may be a fully-qualified

  name.  In this case, the catalog and schemaPattern parameters are

  ignored.


  <P>Each type description has the following columns:

   <OL>

   <LI><B>TYPE_CAT</B> String => the type's catalog (may be null)

   <LI><B>TYPE_SCHEM</B> String => type's schema (may be null)

   <LI><B>TYPE_NAME</B> String => type name

   <LI><B>CLASS_NAME</B> String => Java class name

   <LI><B>DATA_TYPE</B> String => type value defined in java.sql.Types.

   One of JAVA_OBJECT, STRUCT, or DISTINCT

   <LI><B>REMARKS</B> String => explanatory comment on the type

   </OL>


  <P><B>Note:</B> If the driver does not support UDTs, an empty

  result set is returned.


  @param catalog a catalog name; "" retrieves those without a

  catalog; null means drop catalog name from the selection criteria

  @param schemaPattern a schema name pattern; "" retrieves those

  without a schema

  @param typeNamePattern a type name pattern; may be a fully-qualified name

  @param types a list of user-named types to include (JAVA_OBJECT,

  STRUCT, or DISTINCT); null returns all types

  @return <code>ResultSet</code> - each row is a type description

}

function TZAbstractDatabaseMetadata.UncachedGetUDTs(const Catalog: string;

  const SchemaPattern: string; const TypeNamePattern: string;

  const Types: TIntegerDynArray): IZResultSet;

begin

    Result := ConstructVirtualResultSet(UDTColumnsDynArray);

end;


{**

  Creates ab identifier convertor object.

  @returns an identifier convertor object.

}

function TZAbstractDatabaseMetadata.GetIdentifierConvertor:

  IZIdentifierConvertor;

begin

  Result := TZDefaultIdentifierConvertor.Create(Self);

end;


{**

  Add escape character in the pattern that has wildcards character

  @param Pattern The pattern that would be escaped

  @return Escaped Pattern

}

function TZAbstractDatabaseMetadata.AddEscapeCharToWildcards(

  const Pattern: string): string;

var

  i:Integer;

  EscapeChar : string;

begin

  if GetDatabaseInfo.SupportsNonEscapedSearchStrings then

    Result := Pattern

  else

  begin

    EscapeChar := GetDatabaseInfo.GetSearchStringEscape;

    if WildcardsArray<>nil then

    begin

      Result:=StringReplace(Pattern,EscapeChar,EscapeChar+EscapeChar,[rfReplaceAll]);

      for i:=0 to High(WildcardsArray) do

        Result:=StringReplace(Result,WildcardsArray[i],EscapeChar+WildcardsArray[i],[rfReplaceAll]);

    end;

  end;

end;


{**

  Set the Wildcards character for WildcardsArray variable.

  Overrride this method if the wildcards character is different in other database

}

procedure TZAbstractDatabaseMetadata.FillWildcards;

begin

  SetLength(WildcardsArray,1);

  WildcardsArray[0]:='%';

  {SetLength(WildcardsArray,2);

  WildcardsArray[0]:='_';  <---- seems to be a trublemaker, no idea how to test it with our tests. See http://zeoslib.sourceforge.net/viewtopic.php?f=40&t=13184

  WildcardsArray[1]:='%';}

end;


function TZAbstractDatabaseMetadata.NormalizePatternCase(Pattern:String): string;

begin

  if not GetIdentifierConvertor.IsQuoted(Pattern) then

    if FDatabaseInfo.StoresUpperCaseIdentifiers then

      Result := UpperCase(Pattern)

    else if FDatabaseInfo.StoresLowerCaseIdentifiers then

      Result := LowerCase(Pattern)

    else Result := Pattern

  else

    Result := GetIdentifierConvertor.ExtractQuote(Pattern);

end;


{**

  Get the Wildscards in set of char type

  @return TZWildcardsSet type

}

function TZAbstractDatabaseMetadata.GetWildcardsSet:TZWildcardsSet;

var i:Integer;

begin

  Result:=[];

  for i:=0 to High(WildcardsArray) do

    Result:=Result+[WildcardsArray[i]];

end;


//----------------------------------------------------------------------

// Metadata cache key retrieval API (technobot 2008-06-14):


{**

  returns cache key for GetProcedures metadata entry

  @param Catalog a catalog name

  @param SchemaPattern a schema name pattern

  @param ProcedureNamePattern a procedure name pattern

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetProceduresCacheKey(const Catalog: string;

  const SchemaPattern: string; const ProcedureNamePattern: string): string;

begin

  Result := Format('get-procedures:%s:%s:%s',

    [Catalog, SchemaPattern, ProcedureNamePattern]);

end;


{**

  returns cache key for GetProcedureColumns metadata entry

  @param Catalog a catalog name

  @param SchemaPattern a schema name pattern

  @param ProcedureNamePattern a procedure name pattern

  @param ColumnNamePattern a column name pattern

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetProcedureColumnsCacheKey(const Catalog: string;

  const SchemaPattern: string; const ProcedureNamePattern: string;

  const ColumnNamePattern: string): string;

begin

  Result := Format('get-procedure-columns:%s:%s:%s:%s',

    [Catalog, SchemaPattern, ProcedureNamePattern, ColumnNamePattern]);

end;


{**

  returns cache key for GetTables metadata entry

  @param Catalog a catalog name

  @param SchemaPattern a schema name pattern

  @param TableNamePattern a table name pattern

  @param Types table types list

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetTablesCacheKey(const Catalog: string;

  const SchemaPattern: string; const TableNamePattern: string;

  const Types: TStringDynArray): string;

var

  I: Integer;

  Key: string;

begin

  Key := '';

  for I := Low(Types) to High(Types) do

    Key := Key + ':' + Types[I];


  Result := Format('get-tables:%s:%s:%s:%s',

    [Catalog, SchemaPattern, TableNamePattern, Key]);

end;


{**

  returns cache key for GetSchemas metadata entry

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetSchemasCacheKey: string;

begin

  Result := 'get-schemas';

end;


{**

  returns cache key for GetCatalogs metadata entry

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetCatalogsCacheKey: string;

begin

  Result := 'get-catalogs';

end;


{**

  returns cache key for GetTableTypes metadata entry

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetTableTypesCacheKey: string;

begin

  Result := 'get-table-types';

end;


{**

  returns cache key for GetColumns metadata entry

  @param Catalog a catalog name

  @param SchemaPattern a schema name pattern

  @param TableNamePattern a table name pattern

  @param ColumnNamePattern a column name pattern

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetColumnsCacheKey(const Catalog: string;

  const SchemaPattern: string; const TableNamePattern: string;

  const ColumnNamePattern: string): string;

begin

  Result := Format('get-columns:%s:%s:%s:%s',

    [Catalog, SchemaPattern, TableNamePattern, ColumnNamePattern]);

end;


{**

  returns cache key for GetColumnPrivileges metadata entry

  @param Catalog a catalog name

  @param Schema a schema name

  @param Table a table name

  @param ColumnNamePattern a column name pattern

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetColumnPrivilegesCacheKey(

  const Catalog: string; const Schema: string; const Table: string;

  const ColumnNamePattern: string): string;

begin

  Result := Format('get-column-privileges:%s:%s:%s:%s',

    [Catalog, Schema, Table, ColumnNamePattern]);

end;


{**

  returns cache key for GetTablePrivileges metadata entry

  @param Catalog a catalog name

  @param SchemaPattern a schema name pattern

  @param TableNamePattern a table name pattern

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetTablePrivilegesCacheKey(

  const Catalog: string; const SchemaPattern: string;

  const TableNamePattern: string): string;

begin

  Result := Format('get-table-privileges:%s:%s:%s',

    [Catalog, SchemaPattern, TableNamePattern]);

end;


{**

  returns cache key for GetBestRowIdentifier metadata entry

  @param Catalog a catalog name

  @param Schema a schema name

  @param Table a table name

  @param Scope the scope of interest

  @param Nullable include columns that are nullable?

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetBestRowIdentifierCacheKey(

  const Catalog: string; const Schema: string; const Table: string;

  const Scope: Integer; const Nullable: Boolean): string;

begin

  Result := Format('get-best-row-identifier:%s:%s:%s:%d:%s',

    [Catalog, Schema, Table, Scope, BoolToStr(Nullable)]);

end;


{**

  returns cache key for GetVersionColumns metadata entry

  @param Catalog a catalog name

  @param Schema a schema name

  @param Table a table name

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetVersionColumnsCacheKey(

  const Catalog: string; const Schema: string; const Table: string): string;

begin

  Result := Format('get-version-columns:%s:%s:%s', [Catalog, Schema, Table]);

end;


{**

  returns cache key for GetPrimaryKeys metadata entry

  @param Catalog a catalog name

  @param Schema a schema name

  @param Table a table name

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetPrimaryKeysCacheKey(const Catalog: string;

  const Schema: string; const Table: string): string;

begin

  Result := Format('get-primary-keys:%s:%s:%s', [Catalog, Schema, Table]);

end;


{**

  returns cache key for GetImportedKeys metadata entry

  @param Catalog a catalog name

  @param Schema a schema name

  @param Table a table name

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetImportedKeysCacheKey(const Catalog: string;

  const Schema: string; const Table: string): string;

begin

  Result := Format('get-imported-keys:%s:%s:%s', [Catalog, Schema, Table]);

end;


{**

  returns cache key for GetExportedKeys metadata entry

  @param Catalog a catalog name

  @param Schema a schema name

  @param Table a table name

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetExportedKeysCacheKey(const Catalog: string;

  const Schema: string; const Table: string): string;

begin

  Result := Format('get-exported-keys:%s:%s:%s', [Catalog, Schema, Table]);

end;


{**

  returns cache key for GetCrossReference metadata entry

  @param PrimaryCatalog a catalog name for the primary table

  @param PrimarySchema a schema name for the primary table

  @param PrimaryTable the table name that exports the key

  @param ForeignCatalog a catalog name for the foreign table

  @param ForeignSchema a schema name for the foreign table

  @param ForeignTable the table name that imports the key

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetCrossReferenceCacheKey(

  const PrimaryCatalog: string; const PrimarySchema: string;

  const PrimaryTable: string; const ForeignCatalog: string;

  const ForeignSchema: string; const ForeignTable: string): string;

begin

  Result := Format('get-cross-reference:%s:%s:%s:%s:%s:%s',

    [PrimaryCatalog, PrimarySchema, PrimaryTable, ForeignCatalog,

    ForeignSchema, ForeignTable]);

end;


{**

  returns cache key for GetTypeInfo metadata entry

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetTypeInfoCacheKey: string;

begin

  Result := 'get-type-info';

end;


{**

  returns cache key for GetIndexInfo metadata entry

  @param Catalog a catalog name

  @param Schema a schema name

  @param Table a table name

  @param Unique when true, return key for a metadata entry that should contain

      only indices for unique values; when false, return key for a metadata

      entry that may contain indices to non-unique values

  @param Approximate when true, return key for a metadata entry that may include

      approximate or out of data values; when false, return key for a metadata

      entry that should contain only accurate results

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetIndexInfoCacheKey(const Catalog: string;

  const Schema: string; const Table: string; const Unique: Boolean;

  const Approximate: Boolean): string;

begin

  Result := Format('get-index-info:%s:%s:%s:%s:%s',

    [Catalog, Schema, Table, BoolToStr(Unique), BoolToStr(Approximate)]);

end;


{**

  returns cache key for GetSequences metadata entry

  @param Catalog a catalog name

  @param SchemaPattern a schema name pattern

  @param SequenceNamePattern a sequence name pattern

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetSequencesCacheKey(const Catalog: string;

  const SchemaPattern: string; const SequenceNamePattern: string): string;

begin

  Result := Format('get-sequences:%s:%s:%s',

    [Catalog, SchemaPattern, SequenceNamePattern]);

end;


{**

  returns cache key for GetUDTs metadata entry

  @param Catalog a catalog name

  @param SchemaPattern a schema name pattern

  @param TypeNamePattern a type name pattern

  @param Types a list of user-named types to include

  @return the cache key string

}

function TZAbstractDatabaseMetadata.GetUDTsCacheKey(const Catalog: string;

  const SchemaPattern: string; const TypeNamePattern: string;

  const Types: TIntegerDynArray): string;

var

  I: Integer;

begin

  Result := '';

  for I := Low(Types) to High(Types) do

    Result := Result + ':' + IntToStr(Types[I]);

  Result := Format('get-udts:%s:%s:%s%s',

    [Catalog, SchemaPattern, TypeNamePattern, Result]);

end;


{**

  fills string list with the keys for the currently cached metadata entries

  @param List a string list to fill out

}

procedure TZAbstractDatabaseMetadata.GetCacheKeys(List: TStrings);

var

  I: Integer;

begin

  List.Clear;

  with CachedResultSets.Keys do

    for I := 0 to Count-1 do

      List.Add((Items[I] as IZAnyValue).GetString);

end;


// End of metadata cache key retrieval API (technobot 2008-06-14)

//----------------------------------------------------------------------


{ TZVirtualResultSet }


{**

  Creates this object and assignes the main properties.

  @param Statement an SQL statement object.

  @param SQL an SQL query string.

}

constructor TZVirtualResultSet.CreateWithStatement(const SQL: string;

   Statement: IZStatement; ConSettings: PZConSettings);

begin

  inherited CreateWithStatement(SQL, Statement, ConSettings);

end;


{**

  Creates this object and assignes the main properties.

  @param ColumnsInfo a columns info for cached rows.

  @param SQL an SQL query string.

}

constructor TZVirtualResultSet.CreateWithColumns(ColumnsInfo: TObjectList;

  const SQL: string; ConSettings: PZConSettings);

begin

  inherited CreateWithColumns(ColumnsInfo, SQL, ConSettings);

end;


{**

  Destroys this object and cleanups the memory.

}

destructor TZVirtualResultSet.Destroy;

begin

  inherited Destroy;

end;


{**

  Calculates column default values..

  @param RowAccessor a row accessor which contains new column values.

}

procedure TZVirtualResultSet.CalculateRowDefaults(RowAccessor: TZRowAccessor);

begin

end;


{**

  Post changes to database server.

  @param OldRowAccessor a row accessor which contains old column values.

  @param NewRowAccessor a row accessor which contains new or updated

    column values.

}

procedure TZVirtualResultSet.PostRowUpdates(OldRowAccessor,

  NewRowAccessor: TZRowAccessor);

begin

end;


{ TZDefaultIdentifierConvertor }


{**

  Constructs this default identifier convertor object.

  @param Metadata a database metadata interface.

}

constructor TZDefaultIdentifierConvertor.Create(

  Metadata: IZDatabaseMetadata);

begin

  inherited Create;

  FMetadata := Pointer(Metadata);

end;


function TZDefaultIdentifierConvertor.GetMetaData;

begin

  if Assigned(FMetadata) then

    Result := IZDatabaseMetadata(FMetadata)

  else

    Result := nil;

end;


{**

  Checks is the specified string in lower case.

  @param an identifier string.

  @return <code>True</code> is the identifier string in lower case.

}

function TZDefaultIdentifierConvertor.IsLowerCase(const Value: string): Boolean;

var

  I: Integer;

begin

  Result := True;

  for I := 1 to Length(Value) do

  begin

    if not CharInSet(Value[I], ['a'..'z','0'..'9','_']) then

    begin

      Result := False;

      Break;

    end;

  end;

end;


{**

  Checks is the specified string in upper case.

  @param an identifier string.

  @return <code>True</code> is the identifier string in upper case.

}

function TZDefaultIdentifierConvertor.IsUpperCase(const Value: string): Boolean;

var

  I: Integer;

begin

  Result := True;

  for I := 1 to Length(Value) do

  begin

    if not CharInSet(Value[I], ['A'..'Z','0'..'9','_']) then

    begin

      Result := False;

      Break;

    end;

  end;

end;


{**

  Checks is the specified string in special case.

  @param an identifier string.

  @return <code>True</code> is the identifier string in mixed case.

}

function TZDefaultIdentifierConvertor.IsSpecialCase(const Value: string): Boolean;

var

  I: Integer;

begin

  Result := False;

  if CharInSet(Value[1], ['0'..'9']) then

  begin

    Result := True;

    exit;

  end;

  for I := 1 to Length(Value) do

  begin

    if not CharInSet(Value[I], ['A'..'Z','a'..'z','0'..'9','_']) then

    begin

      Result := True;

      Break;

    end;

  end;

end;


{**

  Checks is the string case sensitive.

  @return <code>True</code> if the string case sensitive.

}

function TZDefaultIdentifierConvertor.IsCaseSensitive(const Value: string): Boolean;

const

  AnsiSQLKeywords = 'insert,update,delete,select,drop,create,from,set,values,'

    + 'where,order,group,by,having,into,as,table,index,primary,key,on,is,null,'

    + 'char,varchar,integer,number,alter,column,value,'

    + 'current,top,login,status,version';

var

  Keywords: string;

begin

  if Value = '' then

    Result := False

  else if IsSpecialCase(Value) then

    Result := True

  else if IsLowerCase(Value) then

    Result := Metadata.GetDatabaseInfo.StoresUpperCaseIdentifiers

  else if IsUpperCase(Value) then

    Result := Metadata.GetDatabaseInfo.StoresLowerCaseIdentifiers

  else

    Result := not Metadata.GetDatabaseInfo.StoresMixedCaseIdentifiers;


  { Checks for reserved keywords. }

  if not Result then

  begin

    Keywords := ',' + AnsiSQLKeywords + ','

      + LowerCase(Metadata.GetDatabaseInfo.GetSQLKeywords) + ',';

    Result := Pos(',' + LowerCase(Value) + ',', Keywords) > 0;

  end;

end;


{**

  Checks is the string quoted.

  @return <code>True</code> is the string quoted.

}

function TZDefaultIdentifierConvertor.IsQuoted(const Value: string): Boolean;

var

  QuoteDelim: string;

begin

  QuoteDelim := Metadata.GetDatabaseInfo.GetIdentifierQuoteString;

  Result := (QuoteDelim <> '') and (Value <> '') and (QuoteDelim[1] = Value[1]);

end;


{**

  Extracts the quote from the idenfitier string.

  @param an identifier string.

  @return a extracted and processed string.

}

function TZDefaultIdentifierConvertor.ExtractQuote(const Value: string): string;

begin

  if IsQuoted(Value) then

  begin

    Result := Copy(Value, 2, Length(Value) - 2);

    if not Metadata.GetDatabaseInfo.StoresMixedCaseQuotedIdentifiers then

    begin

      if Metadata.GetDatabaseInfo.StoresLowerCaseQuotedIdentifiers then

        Result := LowerCase(Result)

      else if Metadata.GetDatabaseInfo.StoresUpperCaseQuotedIdentifiers then

        Result := UpperCase(Result);

    end;

  end

  else

  begin

    Result := Value;

    if not Metadata.GetDatabaseInfo.StoresMixedCaseIdentifiers then

    begin

      if Metadata.GetDatabaseInfo.StoresLowerCaseIdentifiers then

        Result := LowerCase(Result)

      else if Metadata.GetDatabaseInfo.StoresUpperCaseIdentifiers then

        Result := UpperCase(Result);

    end;

  end;

end;


{**

  Quotes the identifier string.

  @param an identifier string.

  @return a quoted string.

}

function TZDefaultIdentifierConvertor.Quote(const Value: string): string;

var

  QuoteDelim: string;

begin

  Result := Value;

  if IsCaseSensitive(Value) then

  begin

    QuoteDelim := Metadata.GetDatabaseInfo.GetIdentifierQuoteString;

    if Length(QuoteDelim) > 1 then

      Result := QuoteDelim[1] + Result + QuoteDelim[2]

    else if Length(QuoteDelim) = 1 then

      Result := QuoteDelim[1] + Result + QuoteDelim[1];

  end;

end;


{**

  rerurns cache key for get tables metadata entry

  @param Catalog catalog name

  @param SchemaPattern schema pattern

  @param TableNamePattern table name pattern

  @param Types table types

  @return the cache key string

  @deprecated use TZAbstractDatabaseMetadata.GetTablesCacheKey instead

}

function GetTablesMetaDataCacheKey(Const Catalog:String;

      Const SchemaPattern:String;  Const TableNamePattern:String;const Types: TStringDynArray):String;

Var I : Integer;

    Key :  String;

begin

  Key := '';

  for I := Low(Types) to High(Types) do

    Key := Key + ':' + Types[I];


  Result:= Format('get-tables:%s:%s:%s:%s',

    [Catalog, SchemaPattern, TableNamePattern, Key]);

end;


const

  CharacterSetsColumnsCount = 2;

  CharacterSetsColumns: array[1..CharacterSetsColumnsCount]

    of TZMetadataColumnDef =(

    (Name: 'CHARACTER_SET_NAME'; SQLType: stString; Length: 35),

    (Name: 'CHARACTER_SET_ID'; SQLType: stShort; Length: 0)

  );


  CollationCharSetColumnsCount = 8; //EgonHugeist

  CollationCharSetColumns: array[1..CollationCharSetColumnsCount]

    of TZMetadataColumnDef =(

    (Name: 'COLLATION_CATALOG'; SQLType: stString; Length: 35),

    (Name: 'COLLATION_SCHEMA'; SQLType: stString; Length: 35),

    (Name: 'COLLATION_TABLE'; SQLType: stString; Length: 35),

    (Name: 'COLLATION_COLUMN'; SQLType: stString; Length: 35),

    (Name: 'COLLATION_NAME'; SQLType: stString; Length: 35),

    (Name: 'CHARACTER_SET_NAME'; SQLType: stString; Length: 35),

    (Name: 'CHARACTER_SET_ID'; SQLType: stShort; Length: 0),

    (Name: 'CHARACTER_SET_SIZE'; SQLType: stShort; Length: 0)

  );


  TriggersColumnCount = 8;  //EgonHugeist

  TriggersColumns: array[1..TriggersColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'TRIGGER_CAT'; SQLType: stString; Length: 255),

    (Name: 'TRIGGER_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'TRIGGER_NAME'; SQLType: stString; Length: 255), //RDB$TRIGGER_NAME

    (Name: 'TRIGGER_RELATION'; SQLType: stString; Length: 255), //RDB$RELATION_NAME

    (Name: 'TRIGGER_TYPE'; SQLType: stShort; Length: 0),     //RDB$TRIGGER_TYPE

    (Name: 'TRIGGER_INACTIVE'; SQLType: stShort; Length: 0),     //RDB$TRIGGER_INACTIVE

    (Name: 'TRIGGER_SOURCE'; SQLType: stString; Length: 3000),     //RDB$TRIGGER_SOURCE

    (Name: 'TRIGGER_DESCRIPTION'; SQLType: stString; Length: 255)     //RDB$DESCRIPTION

  );


  ProceduresColumnCount = 8;

  ProceduresColumns: array[1..ProceduresColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'PROCEDURE_CAT'; SQLType: stString; Length: 255),

    (Name: 'PROCEDURE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'PROCEDURE_NAME'; SQLType: stString; Length: 255),

    (Name: 'PROCEDURE_OVERLOAD'; SQLType: stString; Length: 255),

    (Name: 'RESERVED1'; SQLType: stString; Length: 255),

    (Name: 'RESERVED2'; SQLType: stString; Length: 255),

    (Name: 'REMARKS'; SQLType: stString; Length: 255),

    (Name: 'PROCEDURE_TYPE'; SQLType: stShort; Length: 0)

  );


  ProceduresColColumnCount = 13;

  ProceduresColColumns: array[1..ProceduresColColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'PROCEDURE_CAT'; SQLType: stString; Length: 255),

    (Name: 'PROCEDURE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'PROCEDURE_NAME'; SQLType: stString; Length: 255),

    (Name: 'COLUMN_NAME'; SQLType: stString; Length: 255),

    (Name: 'COLUMN_TYPE'; SQLType: stShort; Length: 0),

    (Name: 'DATA_TYPE'; SQLType: stShort; Length: 0),

    (Name: 'TYPE_NAME'; SQLType: stString; Length: 255),

    (Name: 'PRECISION'; SQLType: stInteger; Length: 0),

    (Name: 'LENGTH'; SQLType: stInteger; Length: 0),

    (Name: 'SCALE'; SQLType: stShort; Length: 0),

    (Name: 'RADIX'; SQLType: stShort; Length: 0),

    (Name: 'NULLABLE'; SQLType: stShort; Length: 0),

    (Name: 'REMARKS'; SQLType: stString; Length: 255)

  );


  TableColumnCount = 5;

  TableColumns: array[1..TableColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'TABLE_CAT'; SQLType: stString; Length: 255),

    (Name: 'TABLE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'TABLE_NAME'; SQLType: stString; Length: 255),

    (Name: 'TABLE_TYPE'; SQLType: stString; Length: 255),

    (Name: 'REMARKS'; SQLType: stString; Length: 255)

  );


  SchemaColumnCount = 1;

  SchemaColumns: array[1..SchemaColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'TABLE_SCHEM'; SQLType: stString; Length: 255)

  );


  CatalogColumnCount = 1;

  CatalogColumns: array[1..CatalogColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'TABLE_CAT'; SQLType: stString; Length: 255)

  );


  TableTypeColumnCount = 1;

  TableTypeColumns: array[1..TableTypeColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'TABLE_TYPE'; SQLType: stString; Length: 255)

  );


  TableColColumnCount = 24;

  TableColColumns: array[1..TableColColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'TABLE_CAT'; SQLType: stString; Length: 255),

    (Name: 'TABLE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'TABLE_NAME'; SQLType: stString; Length: 255),

    (Name: 'COLUMN_NAME'; SQLType: stString; Length: 255),

    (Name: 'DATA_TYPE'; SQLType: stShort; Length: 0),

    (Name: 'TYPE_NAME'; SQLType: stString; Length: 255),

    (Name: 'COLUMN_SIZE'; SQLType: stInteger; Length: 0),

    (Name: 'BUFFER_LENGTH'; SQLType: stInteger; Length: 0),

    (Name: 'DECIMAL_DIGITS'; SQLType: stInteger; Length: 0),

    (Name: 'NUM_PREC_RADIX'; SQLType: stInteger; Length: 0),

    (Name: 'NULLABLE'; SQLType: stInteger; Length: 0),

    (Name: 'REMARKS'; SQLType: stString; Length: 255),

    (Name: 'COLUMN_DEF'; SQLType: stString; Length: 255),

    (Name: 'SQL_DATA_TYPE'; SQLType: stInteger; Length: 0),

    (Name: 'SQL_DATETIME_SUB'; SQLType: stInteger; Length: 0),

    (Name: 'CHAR_OCTET_LENGTH'; SQLType: stInteger; Length: 0),

    (Name: 'ORDINAL_POSITION'; SQLType: stInteger; Length: 0),

    (Name: 'IS_NULLABLE'; SQLType: stString; Length: 255),

    (Name: 'AUTO_INCREMENT'; SQLType: stBoolean; Length: 0),

    (Name: 'CASE_SENSITIVE'; SQLType: stBoolean; Length: 0),

    (Name: 'SEARCHABLE'; SQLType: stBoolean; Length: 0),

    (Name: 'WRITABLE'; SQLType: stBoolean; Length: 0),

    (Name: 'DEFINITELYWRITABLE'; SQLType: stBoolean; Length: 0),

    (Name: 'READONLY'; SQLType: stBoolean; Length: 0)

  );


  TableColPrivColumnCount = 8;

  TableColPrivColumns: array[1..TableColPrivColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'TABLE_CAT'; SQLType: stString; Length: 255),

    (Name: 'TABLE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'TABLE_NAME'; SQLType: stString; Length: 255),

    (Name: 'COLUMN_NAME'; SQLType: stString; Length: 255),

    (Name: 'GRANTOR'; SQLType: stString; Length: 255),

    (Name: 'GRANTEE'; SQLType: stString; Length: 255),

    (Name: 'PRIVILEGE'; SQLType: stString; Length: 255),

    (Name: 'IS_GRANTABLE'; SQLType: stString; Length: 255)

  );


  TablePrivColumnCount = 7;

  TablePrivColumns: array[1..TablePrivColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'TABLE_CAT'; SQLType: stString; Length: 255),

    (Name: 'TABLE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'TABLE_NAME'; SQLType: stString; Length: 255),

    (Name: 'GRANTOR'; SQLType: stString; Length: 255),

    (Name: 'GRANTEE'; SQLType: stString; Length: 255),

    (Name: 'PRIVILEGE'; SQLType: stString; Length: 255),

    (Name: 'IS_GRANTABLE'; SQLType: stString; Length: 255)

  );


  BestRowIdentColumnCount = 8;

  BestRowIdentColumns: array[1..BestRowIdentColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'SCOPE'; SQLType: stShort; Length: 0),

    (Name: 'COLUMN_NAME'; SQLType: stString; Length: 255),

    (Name: 'DATA_TYPE'; SQLType: stShort; Length: 0),

    (Name: 'TYPE_NAME'; SQLType: stString; Length: 255),

    (Name: 'COLUMN_SIZE'; SQLType: stInteger; Length: 0),

    (Name: 'BUFFER_LENGTH'; SQLType: stInteger; Length: 0),

    (Name: 'DECIMAL_DIGITS'; SQLType: stShort; Length: 0),

    (Name: 'PSEUDO_COLUMN'; SQLType: stShort; Length: 0)

  );


  TableColVerColumnCount = 8;

  TableColVerColumns: array[1..TableColVerColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'SCOPE'; SQLType: stShort; Length: 0),

    (Name: 'COLUMN_NAME'; SQLType: stString; Length: 255),

    (Name: 'DATA_TYPE'; SQLType: stShort; Length: 0),

    (Name: 'TYPE_NAME'; SQLType: stString; Length: 255),

    (Name: 'COLUMN_SIZE'; SQLType: stInteger; Length: 0),

    (Name: 'BUFFER_LENGTH'; SQLType: stInteger; Length: 0),

    (Name: 'DECIMAL_DIGITS'; SQLType: stShort; Length: 0),

    (Name: 'PSEUDO_COLUMN'; SQLType: stShort; Length: 0)

  );


  PrimaryKeyColumnCount = 6;

  PrimaryKeyColumns: array[1..PrimaryKeyColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'TABLE_CAT'; SQLType: stString; Length: 255),

    (Name: 'TABLE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'TABLE_NAME'; SQLType: stString; Length: 255),

    (Name: 'COLUMN_NAME'; SQLType: stString; Length: 255),

    (Name: 'KEY_SEQ'; SQLType: stShort; Length: 0),

    (Name: 'PK_NAME'; SQLType: stString; Length: 255)

  );


  ImportedKeyColumnCount = 14;

  ImportedKeyColumns: array[1..ImportedKeyColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'PKTABLE_CAT'; SQLType: stString; Length: 255),

    (Name: 'PKTABLE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'PKTABLE_NAME'; SQLType: stString; Length: 255),

    (Name: 'PKCOLUMN_NAME'; SQLType: stString; Length: 255),

    (Name: 'FKTABLE_CAT'; SQLType: stString; Length: 255),

    (Name: 'FKTABLE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'FKTABLE_NAME'; SQLType: stString; Length: 255),

    (Name: 'FKCOLUMN_NAME'; SQLType: stString; Length: 255),

    (Name: 'KEY_SEQ'; SQLType: stShort; Length: 0),

    (Name: 'UPDATE_RULE'; SQLType: stShort; Length: 0),

    (Name: 'DELETE_RULE'; SQLType: stShort; Length: 0),

    (Name: 'FK_NAME'; SQLType: stString; Length: 255),

    (Name: 'PK_NAME'; SQLType: stString; Length: 255),

    (Name: 'DEFERRABILITY'; SQLType: stShort; Length: 0)

  );


  ExportedKeyColumnCount = 14;

  ExportedKeyColumns: array[1..ExportedKeyColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'PKTABLE_CAT'; SQLType: stString; Length: 255),

    (Name: 'PKTABLE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'PKTABLE_NAME'; SQLType: stString; Length: 255),

    (Name: 'PKCOLUMN_NAME'; SQLType: stString; Length: 255),

    (Name: 'FKTABLE_CAT'; SQLType: stString; Length: 255),

    (Name: 'FKTABLE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'FKTABLE_NAME'; SQLType: stString; Length: 255),

    (Name: 'FKCOLUMN_NAME'; SQLType: stString; Length: 255),

    (Name: 'KEY_SEQ'; SQLType: stShort; Length: 0),

    (Name: 'UPDATE_RULE'; SQLType: stShort; Length: 0),

    (Name: 'DELETE_RULE'; SQLType: stShort; Length: 0),

    (Name: 'FK_NAME'; SQLType: stString; Length: 255),

    (Name: 'PK_NAME'; SQLType: stString; Length: 255),

    (Name: 'DEFERRABILITY'; SQLType: stShort; Length: 0)

  );


  CrossRefColumnCount = 14;

  CrossRefColumns: array[1..CrossRefColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'PKTABLE_CAT'; SQLType: stString; Length: 255),

    (Name: 'PKTABLE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'PKTABLE_NAME'; SQLType: stString; Length: 255),

    (Name: 'PKCOLUMN_NAME'; SQLType: stString; Length: 255),

    (Name: 'FKTABLE_CAT'; SQLType: stString; Length: 255),

    (Name: 'FKTABLE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'FKTABLE_NAME'; SQLType: stString; Length: 255),

    (Name: 'FKCOLUMN_NAME'; SQLType: stString; Length: 255),

    (Name: 'KEY_SEQ'; SQLType: stShort; Length: 0),

    (Name: 'UPDATE_RULE'; SQLType: stShort; Length: 0),

    (Name: 'DELETE_RULE'; SQLType: stShort; Length: 0),

    (Name: 'FK_NAME'; SQLType: stString; Length: 255),

    (Name: 'PK_NAME'; SQLType: stString; Length: 255),

    (Name: 'DEFERRABILITY'; SQLType: stShort; Length: 0)

  );


  TypeInfoColumnCount = 18;

  TypeInfoColumns: array[1..TypeInfoColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'TYPE_NAME'; SQLType: stString; Length: 255),

    (Name: 'DATA_TYPE'; SQLType: stShort; Length: 0),

    (Name: 'PRECISION'; SQLType: stInteger; Length: 0),

    (Name: 'LITERAL_PREFIX'; SQLType: stString; Length: 255),

    (Name: 'LITERAL_SUFFIX'; SQLType: stString; Length: 255),

    (Name: 'CREATE_PARAMS'; SQLType: stString; Length: 255),

    (Name: 'NULLABLE'; SQLType: stShort; Length: 0),

    (Name: 'CASE_SENSITIVE'; SQLType: stBoolean; Length: 0),

    (Name: 'SEARCHABLE'; SQLType: stShort; Length: 0),

    (Name: 'UNSIGNED_ATTRIBUTE'; SQLType: stBoolean; Length: 0),

    (Name: 'FIXED_PREC_SCALE'; SQLType: stBoolean; Length: 0),

    (Name: 'AUTO_INCREMENT'; SQLType: stBoolean; Length: 0),

    (Name: 'LOCAL_TYPE_NAME'; SQLType: stString; Length: 255),

    (Name: 'MINIMUM_SCALE'; SQLType: stShort; Length: 0),

    (Name: 'MAXIMUM_SCALE'; SQLType: stShort; Length: 0),

    (Name: 'SQL_DATA_TYPE'; SQLType: stInteger; Length: 0),

    (Name: 'SQL_DATETIME_SUB'; SQLType: stInteger; Length: 0),

    (Name: 'NUM_PREC_RADIX'; SQLType: stInteger; Length: 0)

  );


  IndexInfoColumnCount = 13;

  IndexInfoColumns: array[1..IndexInfoColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'TABLE_CAT'; SQLType: stString; Length: 255),

    (Name: 'TABLE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'TABLE_NAME'; SQLType: stString; Length: 255),

    (Name: 'NON_UNIQUE'; SQLType: stBoolean; Length: 0),

    (Name: 'INDEX_QUALIFIER'; SQLType: stString; Length: 255),

    (Name: 'INDEX_NAME'; SQLType: stString; Length: 255),

    (Name: 'TYPE'; SQLType: stShort; Length: 0),

    (Name: 'ORDINAL_POSITION'; SQLType: stShort; Length: 0),

    (Name: 'COLUMN_NAME'; SQLType: stString; Length: 255),

    (Name: 'ASC_OR_DESC'; SQLType: stString; Length: 255),

    (Name: 'CARDINALITY'; SQLType: stInteger; Length: 0),

    (Name: 'PAGES'; SQLType: stInteger; Length: 0),

    (Name: 'FILTER_CONDITION'; SQLType: stString; Length: 255)

  );


  SequenceColumnCount = 3;

  SequenceColumns: array[1..SequenceColumnCount]

    of TZMetadataColumnDef = (

    (Name: 'SEQUENCE_CAT'; SQLType: stString; Length: 255),

    (Name: 'SEQUENCE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'SEQUENCE_NAME'; SQLType: stString; Length: 255)

  );


  UDTColumnCount = 6;

  UDTColumns: array[1..UDTColumnCount]

    of TZMetadataColumnDef =(

    (Name: 'TYPE_CAT'; SQLType: stString; Length: 255),

    (Name: 'TYPE_SCHEM'; SQLType: stString; Length: 255),

    (Name: 'TYPE_NAME'; SQLType: stString; Length: 255),

    (Name: 'CLASS_NAME'; SQLType: stString; Length: 255),

    (Name: 'DATA_TYPE'; SQLType: stShort; Length: 0),

    (Name: 'REMARKS'; SQLType: stString; Length: 255)

  );


var

  I: Integer;


initialization

  SetLength(CharacterSetsColumnsDynArray, CharacterSetsColumnsCount);

  for I := 1 to CharacterSetsColumnsCount do

    CharacterSetsColumnsDynArray[I - 1] := CharacterSetsColumns[I];


  SetLength(CollationCharSetColumnsDynArray, CollationCharSetColumnsCount);

  for I := 1 to CollationCharSetColumnsCount do

    CollationCharSetColumnsDynArray[I - 1] := CollationCharSetColumns[I];


  SetLength(TriggersColumnsDynArray, TriggersColumnCount);

  for I := 1 to TriggersColumnCount do

    TriggersColumnsDynArray[I - 1] := TriggersColumns[I];


  SetLength(ProceduresColumnsDynArray, ProceduresColumnCount);

  for I := 1 to ProceduresColumnCount do

    ProceduresColumnsDynArray[I - 1] := ProceduresColumns[I];


  SetLength(ProceduresColColumnsDynArray, ProceduresColColumnCount);

  for I := 1 to ProceduresColColumnCount do

    ProceduresColColumnsDynArray[I - 1] := ProceduresColColumns[I];


  SetLength(TableColumnsDynArray, TableColumnCount);

  for I := 1 to TableColumnCount do

    TableColumnsDynArray[I - 1] := TableColumns[I];


  SetLength(SchemaColumnsDynArray, SchemaColumnCount);

  for I := 1 to SchemaColumnCount do

    SchemaColumnsDynArray[I - 1] := SchemaColumns[I];


  SetLength(CatalogColumnsDynArray, CatalogColumnCount);

  for I := 1 to CatalogColumnCount do

    CatalogColumnsDynArray[I - 1] := CatalogColumns[I];


  SetLength(TableTypeColumnsDynArray, TableTypeColumnCount);

  for I := 1 to TableTypeColumnCount do

    TableTypeColumnsDynArray[I - 1] := TableTypeColumns[I];


  SetLength(TableColColumnsDynArray, TableColColumnCount);

  for I := 1 to TableColColumnCount do

    TableColColumnsDynArray[I - 1] := TableColColumns[I];


  SetLength(TableColPrivColumnsDynArray, TableColPrivColumnCount);

  for I := 1 to TableColPrivColumnCount do

    TableColPrivColumnsDynArray[I - 1] := TableColPrivColumns[I];


  SetLength(TablePrivColumnsDynArray, TablePrivColumnCount);

  for I := 1 to TablePrivColumnCount do

    TablePrivColumnsDynArray[I - 1] := TablePrivColumns[I];


  SetLength(BestRowIdentColumnsDynArray, BestRowIdentColumnCount);

  for I := 1 to BestRowIdentColumnCount do

    BestRowIdentColumnsDynArray[I - 1] := BestRowIdentColumns[I];


  SetLength(TableColVerColumnsDynArray, TableColVerColumnCount);

  for I := 1 to TableColVerColumnCount do

    TableColVerColumnsDynArray[I - 1] := TableColVerColumns[I];


  SetLength(PrimaryKeyColumnsDynArray, PrimaryKeyColumnCount);

  for I := 1 to PrimaryKeyColumnCount do

    PrimaryKeyColumnsDynArray[I - 1] := PrimaryKeyColumns[I];


  SetLength(ImportedKeyColumnsDynArray, ImportedKeyColumnCount);

  for I := 1 to ImportedKeyColumnCount do

    ImportedKeyColumnsDynArray[I - 1] := ImportedKeyColumns[I];


  SetLength(ExportedKeyColumnsDynArray, ExportedKeyColumnCount);

  for I := 1 to ExportedKeyColumnCount do

    ExportedKeyColumnsDynArray[I - 1] := ExportedKeyColumns[I];


  SetLength(CrossRefColumnsDynArray, CrossRefColumnCount);

  for I := 1 to CrossRefColumnCount do

    CrossRefColumnsDynArray[I - 1] := CrossRefColumns[I];


  SetLength(TypeInfoColumnsDynArray, TypeInfoColumnCount);

  for I := 1 to TypeInfoColumnCount do

    TypeInfoColumnsDynArray[I - 1] := TypeInfoColumns[I];


  SetLength(IndexInfoColumnsDynArray, IndexInfoColumnCount);

  for I := 1 to IndexInfoColumnCount do

    IndexInfoColumnsDynArray[I - 1] := IndexInfoColumns[I];


  SetLength(SequenceColumnsDynArray, SequenceColumnCount);

  for I := 1 to SequenceColumnCount do

    SequenceColumnsDynArray[I - 1] := SequenceColumns[I];


  SetLength(UDTColumnsDynArray, UDTColumnCount);

  for I := 1 to UDTColumnCount do

    UDTColumnsDynArray[I - 1] := UDTColumns[I];

end.