Manuals / Sybase / Computer Equipment / Server

Sybase 12.4.2 Client/server interfaces to Adaptive Server IQ, Data server for client applications

Models: 12.4.2

1 536

Page 501

C H A P T E R 1 4 Adaptive Server IQ as a Data

Server

About this chapter	Adaptive Server IQ supports client application connections through either
	ODBC or JDBC. This chapter describes how to use Adaptive Server IQ as
	a data server for client applications.
	With certain limitations, Adaptive Server IQ may also appear to certain
	client applications as an Open Server.This chapter also briefly describes
	the restrictions for creating and running these applications.
	For information on developing Open Client applications for use with
	Adaptive Server IQ, see “The Open Client Interface” in Adaptive Server
	Anywhere Programming Interfaces Guide.
	You do not use the facilities described in this chapter to use the remote
	data access capabilities available to IQ users on Windows NT systems.
	For information on remote data access, see the Adaptive Server IQ
	Installation and Configuration Guide for Windows NT.

Client/server interfaces to Adaptive Server IQ

This section describes the key concepts of the Adaptive Server IQ client/server architecture, and provides the conceptual background for the rest of the chapter.

If you simply wish to use a Sybase application or a third-party client application with Adaptive Server IQ, you do not need to know any details of connectivity interfaces or network protocols. However, an understanding of how these pieces fit together may be helpful for configuring your database and setting up applications. This section explains how the pieces fit together, and avoids any discussion of the internal features of the pieces. For more details about third party client applications, see the Adaptive Server IQ Installation and Configuration Guide.

481

Page 501

Image 501

Sybase 12.4.2 manual Client/server interfaces to Adaptive Server IQ, Data server for client applications, 481

Contents

Adaptive Server IQ Administration and Performance GuideDocument ID Contents Contents 101 100103 104132 Contents Deleting views 131 Views in the system tables135 138Vii Viii 255 Using cursors on Select statements in procedures 253273 277285 Contents Referential integrity is unenforced 284299 309339 323352 Managing User IDs and PermissionsXii Xiii 454 448459 467476 473479 481Xvi How to use this book AudienceXvii Related documents Guide to using this book To learn how to Read this chapterRelated documents Documentation for Adaptive Server IQXix About This BookRelated documents Introduction to Adaptive Server IQ Overview of IQ system administrationSystem administration tasks System administration tasksOverview of Adaptive Server IQ System Administration Administrative tasksSecurity overview Tools for system administration Tools for system administrationTypes of users Granting permissionsCatalogs and IQ Database serverIQ Store Adaptive Server Anywhere and Adaptive Server IQTemporary Store Catalog StoreConcurrent operations Stored proceduresStored procedures Adaptive Server IQ stored proceduresStored Procedures for the IQ Store Procedure name Purpose Adaptive Server Enterprise system and catalog proceduresSystem procedure Description Adaptive Server Enterprise system proceduresAdaptive Server Enterprise catalog procedures Catalog stored proceduresCatalog procedure Description Procedure name PurposeSystem tables and views System tables and viewsSystem table Description Sysdomain Syslogin Sysuserauth System view DescriptionCommands and Functions Commands and FunctionsTypes of SQL statements FunctionsMessage logging Manipulate date and time data for example, TODAY, DatediffFourth line of the file contains version information Utility database Utility databaseCompatibility with earlier versions Compatibility with earlier versions Starting the database server Server command lines Server command linesGeneral form for the server command line is as follows Running Adaptive Server IQ Starting the server on UnixUsing the startup utility To start the server on Unix using the startup utilityStarting the server on Unix Typing the server startup command Starting the server on Windows NT Starting the server from the NT Start menuStarting the server on Windows NT Running the server outside the current session Running the server as a Windows NT service Using command-line switchesUsing command-line switches Running the Unix database server as a daemonCase sensitivity Using configuration files Elora 16M Tcpipport=2367 -gm Gp 4096 path\mydb.db Required if you do not supply a database Naming the server and databasesWindow Database startedSample database on that server Setting memory switches Controlling performance from the command lineThis switch as the number of megabytes of wired memory Default value of -iqgovernis 2 x the number of CPUs +10Use Concurrent user connections on a particular serverSetting switches that affect timing Other performance-related switches Controlling permissions from the command lineSetting a maximum Catalog page size Selecting communications protocols Setting up a client/server environmentLimiting inactive connections Starting a server from Dbisql Starting a server in forced recovery modeServer from Dbisql Connections, and Catalog page sizeStarting multiple servers or clients on the same machine Monitoring server activityCapture server activity in a log file Log file name has this formatMonitoring server activity Stopping the database server PID Stopping the database serverShutting down operating system sessions Who can stop the server?Following example stops a server from Dbisql Will be stopped even if there are connections to itStarting and stopping databases Starting and stopping databasesFrom a command line, type the following command Command that executes when you perform these steps isStarting the asiqdemo database Starting and stopping Sybase Central Starting and stopping Sybase CentralConnecting to a plug-in Connecting a plug-inIntroduction to connections Stopping Sybase CentralIntroduction to connections If you want Consider reading How connections are establishedConnection parameters are passed as connection strings Connection parameters specify connectionsFollowing form This is equivalent to the following connection stringSimple connection examples Simple connection examples Connecting to a database from DbisqlIf you need to start the sample database, enter To connect from a Unix systemTo connect from a Windows NT system Connecting to other databases from Dbisql PasswordEnter the user ID Connecting to an embedded database Start Dbisql by typing at a system command promptTo connect to a database from Dbisql on Unix To connect to an embedded database from Dbsql in Windows NT Extra cache needed for JavaTo connect using a data source Connecting using a data sourceConnecting to a server on a network Using default connection parameters Named server, using the default database Connecting from Adaptive Server IQ utilitiesYou may connect to the wrong server DatabaseWorking with Odbc data sources Working with Odbc data sources DSNs and FILEDSNsCreating and editing Odbc data sources You could also use the host network address. For example Creating and editing Odbc data sourcesTo create an Odbc User Data Source To test an Odbc Data SourceOdbc tab Configuring Odbc data sourcesPrevent Driver Not Capable errors Login tab Database tabSelecting this Advanced tab Network tabCreating a File Data Source Enter any additional switches hereName of the file Which the debugging information is to be savedUsing Odbc data sources on Unix Using Odbc data sources on UnixShort Parameter Form Argument Description Connection parametersConnection parameters Parameters Not supported in Odbc connectionsOr NO, OFF, 0, or False if false Connection parameters and their values are case insensitiveSpecify database names using DBN Specify database files using DBFConnection parameter priorities Use the Start parameter to specify cache sizeSteps in establishing a connection How Adaptive Server IQ makes connectionsLocating the interface library How Adaptive Server IQ makes connectionsUnix dblib6 with an operating system-specific extension Connection file Assembling a list of connection parametersAutoStop Ignored if the database is already loaded ParameterIs already running Ways by supplying network communication parameters Locating a serverHow Adaptive Server IQ makes connections Locating the database Server name caching for faster connections Interactive SQL connections Connecting from other databasesUsing an integrated login Using an integrated loginUsing integrated logins Enabling the integrated login featureTo use an integrated login Creating an integrated login To map an integrated login from Sybase CentralTo map an integrate login using a SQL statement Connecting from a client application Following Dbisql statementCan connect to a database if all the following are true Security concerns unrestricted database access Setting temporary public options for added security Creating a default integrated login user Network aspects of integrated loginsTroubleshooting startup, shutdown, and connections What to do if you can’t start Adaptive Server IQEnsure that your files are valid Troubleshooting startup, shutdown, and connections Debugging network communications startup problemsEnsure that network communication software is running Check environment variablesWhat to do if you can’t connect to a database Stopping a database server in an emergency Unix Resolving problems with your Dbisql window on UnixRunning Adaptive Server IQ Troubleshooting startup, shutdown, and connections Designing your database Building Your Adaptive Server IQ DatabasesTools for working with database objects Using Sybase Central to work with database objectsBuilding Your Adaptive Server IQ Databases 100Using Dbisql to work with database objects Step-by-step overview of database setupWorking with Database Objects 101To set up an IQ database Scheduling data definition tasks102 103 Extending data definition privilegesSelecting a device type Allocating space for databases104 105 Estimating space and dbspaces requiredWorking with databases Working with databases106 107 Creating a database108 109 110 111 Choosing an IQ page sizeSpecifying the size of your database Choosing a Catalog page size112 Enabling Java in the database Choosing a block size for your databaseIQ Store size is 8MB and the Temporary Store is 4MB 113114 Adding dbspacesTo create a dbspace in Sybase Central 115116 Dropping dbspaces117 =======================================================Dropping a database Working with tablesCreating tables Working with tables119 120 Types of tablesType of table Permitted placement Default placement Table placementAutomatic index creation for IQ tables 121Data type of the column and its width Optimizing storage and query performanceSee the following table for implications of IQ Unique 122123 Altering tablesDropping tables 124To drop a table in Sybase Central Creating primary and foreign keys 125To create a primary key in Sybase Central 126 Table information in the system tables Working with views127 To create an unenforced foreign key in Sybase CentralWorking with views Creating viewsDefinition in the database system tables 128Using views 129To create a view in Sybase Central Permissions on views Modifying viewsAn existing view definition Alter View statement maintains the permissions on the viewDeleting views Views in the system tables131 Introduction to indexes Working with indexesWorking with indexes 132Creating indexes Indexes in the system tables133 134 Removing indexesAdaptive Server IQ index types Overview of indexesIndexing 135136 Overview of indexesBenefits over traditional indexes Adaptive Server IQ Indexes137 Create Index statement Creating Adaptive Server IQ indexesCreating Adaptive Server IQ indexes Region column of the salesorder tableCreating indexes concurrently Creating an index with Sybase Central139 To create an index with Sybase CentralChoosing an index type Choosing an index type140 Number of unique values in the index Types of queries141 142 Query type/indexType of Query Usage Recommended Index Type Indexing criteria disk space usage Only the default index supports the following data typesData types in the index 143Combining index types Adaptive Server IQ index typesAdaptive Server IQ index types 144LowFast LF index type Default column indexProjections on few rows Recommended useAdvantages and disadvantages of LowFast HighGroup HG index typeComparison with other indexes Additional indexesAutomatic creation of HighGroup index Advantages and disadvantages of HighGroup147 HG advantages/disadvantages Advantages DisadvantagesHighNonGroup HNG index type Advantages and disadvantages of HighNonGroup148 Comparison to other indexes Optimizing performance for ad hoc joinsHighGroup index is also appropriate for an HNG column 149Selecting an index 150Criteria to identify Index to select Adding column indexes after inserting data Using join indexesJoin indexes improve query performance 151How join indexes are used for queries When a join becomes ad hocRelationships in join indexes Join hierarchy overview153 Columns in the join indexJoin hierarchy in query resolution One-to-many relationship154 Custid Lname 155156 Multiple table joins and performance157 Steps in creating a join indexSynchronizing join indexes Privileges needed to create a join index158 Defining join relationships between tables Performance hints for synchronization159 Using foreign references Examples of join relationships in table definitions160 Specifying the join type when creating a join index Specifying relationships when creating a join index161 Parameters of this command are Issuing the Create Join Index statement162 163 Types of join hierarchies Creating a join index in Sybase Central164 To add a join index in Sybase CentralLinear joins Star joins165 You can create this table using the following commands Another table166 167 Modifying tables included in a join index168 Inserting or deleting from tables in a join indexTable versioning controls access to join indexes Estimating the size of a join index169 170 Estimating the size of a join indexImport and export methods Import and export overviewDatabases 171Import and export overview Input and output data formats172 File Format DescriptionPermissions for modifying data Scheduling database updatesSpecifying an output format for Interactive SQL Moving Data In and Out of DatabasesExporting data from a database Using output redirectionExporting data from a database 174Bulk loading data using the Load Table statement Null value output175 176 Bulk loading data using the Load Table statementFormat ’ascii’ ’binary’ Delimited by string Quotes on OFF Escapes on OFF Escape Character characterBinary with Null Byte Prefix 1 2 4 ’delimiter-string’ 177178 179 180 Block Factor number Block Size number 181Preview on OFF ROW Delimited by ’delimiter-string’ Start ROW ID numberSpecifies the byte ordering during reads. This On default is NATIVE. You can also specifyEndian platforms like DEC ALPHA, and Windows NT Here is a Windows NT exampleSpecifies the maximum number of rows to insert into Table. The default is 0 for no limitOptions work together 183184 Carriage return \x0d Following Windows NT example sets the column delimiter forWith the Limit option, and takes precedence over it 185186 Memory message Interpreting notification messagesThis message displays memory usage information 187IQ Temporary Store blocks message Main IQ Store blocks messagesMain buffer cache activity message 188Controlling message logging Temporary buffer cache messageThese lines display information about the Temp buffer cache See the description for the Main buffer cache message aboveUsing the Insert statement Using the Insert statementInserting specified values row by row 190Complete description of Adaptive Server IQ data types Inserting selected rows from the databaseFollowing example adds 1995-06-09 into the lshipdate column Into the lorderkey column in the lineitem tableInserting from a different database Inserting selected rows from the database192 Lineitem table in the current database Issue a Commit to commit the insert193 To insert data directly from Adaptive Server Enterprise194 Importing data interactively Inserting into tables of a join index195 Inserting into primary and foreign key columns Inserting into primary and foreign key columns196 197 Partial-width insertionsPartial-width insertion rules Partial-width insertions198 Additional columns QueryInstead of the correct number 199200 Start ROW ID option in the second Load Table statement201 IndexConverting data on insertion Converting data on insertion202 203 Load conversion options Inserting data from pre-Version 12 Adaptive Server IQ204 Conversion options for loading from flat files205 Data conversions in IQIQ conversions for comparison operations 206IQ conversions for arithmetic operations 207Column width issues Using the Ascii conversion option208 209 Substitution of Null or blank characters Date OptionSpecifying the Date Format 210211 Setting Year specified as Years assumed Datetime conversion option212 213 Specifying the format for Datetime conversions214 Formatting times10 Datetime format options Where Blanks indicates that blanks convert to Nulls Working With Nulls215 Other factors affecting the display of data Other factors affecting the display of data216 Matching Adaptive Server Enterprise data types Unsupported Adaptive Server Enterprise data types217 Adaptive Server Enterprise data type equivalents Matching Adaptive Server Enterprise data types218 Adaptive Server Adaptive Server IQ Enterprise Datatype 21913 Character data types Adaptive Server Enterprise Datatype IQ DatatypeHandling conversion errors on data import 22015 DATE/TIME data types Improving load performance during database definition Tuning bulk loading of dataOptimizing for the number of distinct values Creating indexesAdjusting your environment at load time Setting server startup optionsTuning bulk loading of data Adding dbspaces223 Reducing Main IQ Store space use in incremental loadsChanging data using Update Changing data using Update224 225 Deleting dataImporting data by replication Importing data by replication226 227 228 Adaptive Server IQ Overview of proceduresStatements, are also available in batches 229Introduction to procedures Benefits of proceduresBenefits of procedures 230Creating procedures Using Procedures and Batches231 Dropping procedures Calling proceduresIntroduction to procedures 232Permissions to execute procedures Returning procedure results in parameters233 Returning procedure results in result sets 234Employee ID Salary Introduction to user-defined functions Creating user-defined functions235 Introduction to user-defined functions Calling user-defined functions236 Fullname empfname, emplnamePermissions to execute user-defined functions Dropping user-defined functionsFollowing statement revokes permission to use the function 237Introduction to batches Introduction to batches238 Control statements 239Dbisql and batches Control statements Using compound statements240 Control statement Syntax241 Declarations in compound statements242 Atomic compound statementsStructure of procedures SQL statements allowed in procedures243 Declaring parameters for procedures Structure of procedures244 Passing parameters to functions Passing parameters to proceduresOr as follows 245Returning a value using the Return statement Returning results from proceduresReturning results from procedures 246247 Returning results as procedure parametersShow the number of orders placed by the customer with ID Declared in the procedure argument listCustomerID parameter is declared as an in parameter. This Orders variable that is returned to the calling environment249 Returning result sets from proceduresReturning variable result sets from procedures Returning multiple result sets from proceduresProcedure 250251 Using cursors in proceduresCursor management overview Using cursors in proceduresCursor positioning 252253 Using cursors on Select statements in procedures254 255 Errors and warnings in proceduresDefault error handling in procedures Errors and warnings in procedures256 257 258 Error handling with on Exception ResumeOn Exception Resume Begin 259260 Default handling of warnings in procedures261 Using exception handlers in procedures262 263 Nested compound statements and exception handlersUsing the Execute Immediate statement in procedures Following statement executes the InnerProc procedure264 Some tips for writing procedures Transactions and savepoints in proceduresCheck if you need to change the command delimiter 265Use fully-qualified names for tables in procedures Remember to delimit statements within your procedureSpecifying dates and times in procedures Some tips for writing proceduresVerifying procedure input arguments Statements allowed in batches267 Calling external libraries from procedures Using Select statements in batches268 269 Creating procedures and functions with external callsExternal function declarations Following form for Microsoft Visual C++270 271 How parameters are passed to the external function272 Special considerations when passing character typesData integrity overview How data can become invalid273 Integrity constraints belong in the database Data integrity overview274 Data integrity tools How database contents get changed276 SQL statements for implementing integrity constraintsUsing table and column constraints Using Unique constraints on columns or tables277 Using Check conditions on columns Using IQ Unique constraint on columnsUsing table and column constraints 278Column Check conditions from user-defined data types Option279 Working with column constraints in Sybase Central Using Check conditions on tablesModifying and deleting Check conditions 280281 Declaring entity and referential integrityEnforcing entity integrity If a client application breaches entity integrity282 Primary keys enforce entity integrity Declaring referential integrity283 How you define foreign keys Referential integrity is unenforced284 285 Integrity rules in the system tables286 Integrity rules in the system tablesOverview of transactions and versioning Performance and other aspects of database administrationIntroduction to transactions Transactions are logical units of workStarting transactions Using transactionsCompleting transactions Overview of transactions and versioningCommitting a transaction writes data to disk Options in DbisqlTransactions and Versioning 289Subdividing transactions Introduction to concurrencyHow concurrency works in IQ 290Why concurrency benefits you Concurrency for backupsIntroduction to versioning Concurrency and IQ MultiplexTable-level versioning One writer and multiple readers at the table level292 Only one writer at a time 293294 Multiple writers and readers in a database295 Transactions use committed data296 Timing of commits on read transactions affects versions297 Hold cursors span transactionsHow Adaptive Server IQ keeps track of versions Versioning of temporary tables298 How locking works Versioning prevents inconsistenciesLocks for DML operations 299Locks for DDL operations How locking works300 301 Primary keys and locking Isolation levelsIsolation levels 302303 Checkpoints, savepoints, and transaction rollbackWhen checkpoints occur Checkpoints aid in recoveryCheckpoints Checkpoints, savepoints, and transaction rollbackSavepoints within transactions Releasing savepoints305 Automatic and user-defined savepoints Rolling back to a savepointNaming and nesting savepoints Following scenarioRolling back transactions System recoveryWhat causes a rollback Effect of rollback308 How transaction information aids recovery309 Performance implicationsOverlapping versions and deletions Performance implications310 311 Cursors in transactionsCursor sensitivity Cursors and versioningCursor scrolling Cursors in transactionsHold cursors Cursor command syntax and examplesPositioned operations Controlling message logging for cursors314 Installation to handle international language issues Adaptive Server IQ international featuresIntroduction to international languages and character sets 315Character set questions and answers Using the default collationIntroduction to international languages and character sets 316Pieces in the character set puzzle Understanding character sets in softwareInternational Languages and Character Sets 317Language issues in client/server computing 318Database server software messages Applications can cause 319 Code pages in Windows and Windows NT320 Ansi and OEM code pages in Windows and Windows NT321 Multibyte character setsInternational aspects of case sensitivity Sorting characters using collationsFirst-byte collation orderings for multibyte character sets 322Introduction to locales Understanding localesCase insensitivity of identifiers 323Understanding the locale language Understanding locales324 Understanding the locale character set 325Alternative Language label Label ISO639 language code Equivalent Iana labels and a description 326Character set Label Iana label Description 327 Understanding collations Setting the Sqllocale environment variableUnderstanding the locale collation label Displaying collationsFollowing collations are supplied with Adaptive Server IQ Supplied collations329 Collation Label Type Description330 331 Ansi or OEM?332 333 334 335 Understanding character set translation Using multibyte collationsCharacter translation for database messages Understanding character set translationTo use character translation for database messages 337Connection strings and character sets Avoiding character-set translation338 Collation internals 339Language Character set Title line Comment linesCollation internals 340Collation sequence section Specification DescriptionFollowing are some sample lines for a collation 341That will be sorted together Encodings sectionFollowing is part of the Shift-JIS collation file 342343 Properties sectionConfiguring your character set environment Finding the default collationTo configure your character set environment International language and character set tasksDetermining locale information You can determine locale information using system functions345 To determine the locale of a database serverCreating a database with a named collation Setting localesYour current machine 346347 List the supplied collation sequencesUsing Odbc code page translation Starting a database server using character set translationTo enable character-set translation on a database server Or on UnixCreating a custom collation Character set translation for Sybase Central and DbisqlSet the Dbisql option CHAROEMTranslation to a value of OFF 349350 Creating a database with a custom collation Compatibility issues351 To create a database with a custom collationPerformance issues Performance issues352 An overview of database permissions Manage user IDs353 DBA authority overview An overview of database permissions354 Ownership permissions overview Resource authority overviewTable and views permissions overview Managing User IDs and PermissionsManaging individual user IDs and permissions Group permissions overview356 With the following command Changing a passwordCreating new users 357358 Granting DBA and resource authority359 Granting permissions on tables and viewsContext of groups in Permissions of groups Granting users the right to grant permissions360 To grant user permission on tables in Sybase CentralGranting permissions on procedures To grant user permissions on procedures in Sybase Central361 362 Revoking user permissionsManaging groups To create a group with a name and passwordCreating groups 363Managing groups Granting group membership to users364 To create a group in Sybase CentralPermissions of groups Referring to tables owned by groups365 366 Groups without passwordsDatabase object names and prefixes Special groups367 368 Database object names and prefixesUsing views and procedures for extra security Following command will now work369 Using views for tailored security Using views and procedures for extra security370 Using procedures for tailored security Grant permission for the Sales Manager to examine this view371 Managing the resources connections use How user permissions are assessedHow user permissions are assessed Be modified is strictly defined373 Temporary StoreUsers and permissions in the system tables Users and permissions in the system tablesLimits the number of prepared 374Default Contents Views Default Contents375 376 377 Backup protects your dataData in backups Types of backupsBacking up your database Backing up your databaseTransaction log in backup, restore, and recovery Backup and Data Recovery379 Disk backup requirements Distribution of backup dataTape backup requirements Selecting archive devicesObtaining DBA privileges Preparing for backupRewinding tapes 381Two ways to run Backup Retaining old disk backupsYou can run Backup in two ways Estimating Media CapacityBackup statement Concurrency and backupsTo back up an IQ database, use the following syntax 383Specifying operator presence Specifying the type of backupSpecifying archive devices 384385 386 387 Other backup options Backup ExamplesWaiting for Tape Devices 388Checking for backup space Recovery from errors during backupRecovery attempts 389Performing backups with non-Sybase products After you complete a backupDo not specify the Stacker or Size parameters 390Performing system-level backups Shutting down the database391 Performing system-level backups Restoring from a system-level backupBacking up the right files 392Validating your database 393For this size database It takes about this long Validating your database Interpreting results394 Orphaned block statistic Meaning395 Concurrency issues for spiqcheckdbRestoring your databases Before you restoreRestoring your databases 396397 Restore accommodates dbspace changesRestoring tape backup files Restoring disk backup filesSpecifying files for an incremental restore Keeping the database unchanged between restoresRestoring from a compatible backup Restore statementTo restore a database, use the following syntax 399400 Moving database files401 402 Restoring in the correct order Adjusting data sources and configuration filesDisplaying header information 403Set, and the restore order, are as follows Set must be restored first, and must be in the first device404 Dblog command-line utility Renaming the transaction log after you restoreSwitch Description 405Restore requires exclusive write access Validating the database after you restoreTransaction log utility options Maintaining a transaction log or mirror407 Displaying header informationRecovery from errors during restore Using Symbolic Links Unix Only408 409 Unattended backupLocating the backup log Getting information about backups and restoresGetting information about backups and restores 410411 Content of the backup logViewing the backup log in Sybase Central Maintaining the backup logRecording dbspace names 412413 Determining your data backup and recovery strategyDetermining the type of backup Scheduling routine backupsDetermining your data backup and recovery strategy 414Improving performance for backup and restore Designating Backup and Restore ResponsibilitiesIncreasing the number of archive devices 415Increasing memory used during backup Spooling backup dataEliminating data verification Balancing system load417 Controlling the size of the Catalog Store418 Your hardware and software configuration DBA can tune performance by adjusting resource usageIntroduction to performance terms Designing for performancePaging increases available memory Overview of memory useOverview of memory use 420Server memory Utilities to monitor swappingManaging System Resources 421Managing buffer caches Determining the sizes of the buffer caches422 Operating system and other applications Adaptive Server IQ memory overhead423 424 Multi-user database accessRaw partitions versus file systems Memory requirements for loadsAdaptive Server IQ main and temp buffer caches 425Buffer caches and physical memory 426 Example of setting buffer cache sizesOther considerations Memory available for buffer caches ExampleSetting buffer cache sizes Methods of adjusting buffer cache sizes427 Setting buffer cache size database options 428To change the buffer cache sizes permanently Setting the page size Setting buffer cache size server switchesNormally you change the buffer cache sizes by setting Specifying page size430 Block sizeAdjust blocking factor for loads Decrease buffer cache settingsSaving memory Data compressionActively using the database IQ command line option changesOptimizing for large numbers of users Use the following guideline to determine Block FactorIQ Temp space Command and set rlimfdmax=4096 in /etc/systemSystem parameters 433434 Platform-specific memory optionsPhysical size of memory on the system Recommendations for small memory configurationsOptions that can provide more memory 435436 Managing large buffer caches on HP You must then restart the server with the following commandControlling file system buffering 437Options for Java-enabled databases Other ways to get more memory438 439 Process threading modelIQ options for managing thread usage Insufficient threads errorProcess threading model 440Balancing I/O Raw I/O on Unix operating systems441 Setting up disk striping on Unix Using disk stripingSetting up disk striping on Windows NT Balancing I/OInternal striping Recommendations for disk striping443 Disk striping option Disk striping hints444 Temporary data with the Create Dbspace command Using multiple dbspacesTransaction log file Across multiple disksStrategic file locations Message log446 447 Working space for inserting, deleting, and synchronizingOptions for tuning resource use Options for tuning resource useRestricting concurrent queries 448Limiting queries by rows returned Limiting a query’s memory useForcing cursors to be non-scrolling 449Limiting the number of statements Limiting the number of cursorsLowering a connection’s priority Prefetching cache pagesOther ways to improve resource use Restricting database accessOptimizing for typical usage Disk cachingIndexing tips Using RAM diskPicking the right index type Indexing tipsUsing join indexes Allowing enough disk space for deletions453 Managing the size of your database Managing database size and structureDenormalizing for performance Managing database size and structureDisadvantages of denormalization Denormalization has risksPerformance benefits of denormalization 455Deciding to denormalize Improving your queriesTips for structuring queries Improving your queriesPlanning queries Query evaluation options457 458 Setting query optimization optionsNetwork performance Improving large data transfers459 Isolate heavy network users Network performance460 461 Put small amounts of data in small packets462 Put large amounts of data in large packetsProcess at the server level Filter as much data as possible at the server level463 464 Other chapters of this guide for more tuning hints Getting information using stored proceduresViewing the Adaptive Server IQ environment Set to control resource use, see , Managing System466 Viewing the Adaptive Server IQ environmentMonitoring the buffer caches Monitoring and Tuning PerformanceStarting the buffer cache monitor 467468 Monitoring the buffer caches469 470 471 Examining and saving monitor results Stopping the buffer cache monitor472 Into dummytablename Stop MonitorExamples of monitor results Buffer cache473 474 -contentionresults for the temp cache are -contentionresults for the main cache areResults for the memory manager are 475Avoiding buffer manager thrashing Avoiding buffer manager thrashing476 Monitoring paging on Unix systems Monitoring paging on Windows NT systemsHere is an example 477478 479 System utilities to monitor CPU use480 System utilities to monitor CPU useData server for client applications Client/server interfaces to Adaptive Server IQRestrictions for creating and running these applications 481482 Client/server interfaces to Adaptive Server IQInterfaces file Configuring IQ Servers with DseditAdaptive Server IQ as a Data Server 483Opening a Directory Services session Using the Dsedit utilityStarting Dsedit 484Adding or changing the server address Adding a server entryInterfaces file sql.ini Select a server entry in the Server box486 Network Settings, in the Control PanelVerifying the server address Renaming a server entry487 Open Client applications and Adaptive Server IQ Sybase applications and Adaptive Server IQDeleting server entries 488System requirements Setting up Adaptive Server IQ as an Open ServerStarting the database server as an Open Server 489Configuring your database for use with Open Client Setting up Adaptive Server IQ as an Open Server490 Characteristics of Open Client and jConnect connections 491Option Set to Characteristics of Open Client and jConnect connections To change the option settings for TDS connections492 Servers with multiple databases To connect to the livecredit server, use this syntax493 494 495 Index496 IndexWINLATIN1 497Datetime 498Odbc Unix 499500 DDL 501Pipenotconnected 502503 See Also Dbisql 504505 506 Null 507TCP/IP 508See Also stored 509Rawdetect 510511 512 513 514 515 516

C H A P T E R 1 4 Adaptive Server IQ as a Data

a data server for client applications.

the restrictions for creating and running these applications.

Anywhere Programming Interfaces Guide.

Client/server interfaces to Adaptive Server IQ

481