HP c-tree-SQL ISQL and Tools manual Formatting Column Display with the Column Statement

Page 32

ISQL and Tools

3.4.1Formatting Column Display with the COLUMN Statement

You can specify the width of the display for character columns with the COLUMN statement's "An" format string. Specify the format string in the FORMAT clause of the COLUMN state- ment. You need to issue separate COLUMN statements for each column whose width you want to control in this manner.

The following example shows COLUMN statements that limit the width of the

customer_name and customer_city columns, and re-issues the original query to show how they affect the results.

Example 3-2: Controlling Display Width of Character Columns

ISQL> COLUMN CUSTOMER_NAME FORMAT "A19"

ISQL> COLUMN CUSTOMER_CITY FORMAT "A19"

ISQL> select c.customer_name, c.customer_city, o.order_id, o.order_value from customers c, orders o

where o.customer_id = c.customer_id order by c.customer_name;

CUSTOMER_NAME

CUSTOMER_CITY

ORDER_ID ORDER_VALUE

-------------

-------------

--------

-----------

Aerospace Enterpris

Scottsdale

13

3000000

Aerospace Enterpris

Scottsdale

14

1500000

Chemical Constructi

Joplin

11

3000000

Chemical Constructi

Joplin

12

7500000

Luxury Cars Inc.

North Ridgeville

21

6000000

Luxury Cars Inc.

North Ridgeville

20

5000000

Note that ISQL truncates display at the specified width. This means you should specify a value in the FORMAT clause that accommodates the widest column value that the query will display.

To improve the formatting of the order_value column, use the COLUMN statement's numeric format strings. Issue another COLUMN statement, this one for order-_value, and specify a for- mat string using the "$", "9", and "," format-string characters:

The format-string character 9 indicates the width of the largest number. Specify enough 9 format-string characters to accommodate the largest value in the column.

The format-string character $ directs ISQL to precede column values with a dollar sign.

The comma (,) format-string character inserts a comma at the specified position in the dis- play.

For the order_value column, the format string "$99,999,999.99" displays values in a format that clearly indicates that the values represent money. (For a complete list of the valid numeric format characters, see Table 3-3: Numeric Format Strings for the COLUMN Statement on page 3-18.)

The following example shows the complete COLUMN statement that formats the order_value column. As shown by issuing the COLUMN statement without any arguments, this example retains the formatting from the COLUMN statements in the previous example.

3-6

FairCom Corporation

Image 32
Contents Isql and Tools Reference Guide For use with c-treeSQL ServerPage Table of Contents Data Load Utility dbload Tutorial Source Code IiiFairCom Corporation Syntax Diagram Conventions Documentation OverviewPurpose of this Manual AudienceRelated Documentation Isql and ToolsIntroduction OverviewIsql and Tools FairCom Corporation Quick Tour Introductory TutorialInit IsqlDefine ManageIsql Create Table Custmast Isql Commit Work CustmastQuick Tour DoneComplete Introductory Tutorial Code Relational Model and Indexing Tutorial ISQLTutorial2.sqlQuick Tour Values Insert IntoValues Insert Into Commit Work QTY PriceComplete Relational Model and Indexing Tutorial Source Code Locking Tutorial ISQLTutorial3.sql@ISQL @iSQLTutorial3.sql Isql Delete from Custmast Complete Locking Tutorial Source Code Transaction Processing Tutorial ISQLTutorial4.sqlTransaction Rollback Work Complete Transaction Processing Tutorial Source Code Isql Statements Starting Interactive SQLSyntax ArgumentsPassword Statement History SupportUsername ConnectstringFormatting Output of Isql Queries Isql StatementsIsql Statements for Statement History Support Statement SummaryIsql Statements for Query Formatting Summary DisplayExample 3-1 Unformatted Query Display from Isql Customername Customercity Orderid OrdervalueFormatting Column Display with the Column Statement Example 3-2 Controlling Display Width of Character ColumnsCustomername Customercity Example 3-3 Customizing Format of Numeric Column DisplaysOrdervalue Example 3-4 Specifying Column Breaks and Values with Display Numorders Customername Example 3-6 Specifying a Query Header and Footer with Title Help and Table Statements Transaction SupportIsql Reference 1 @ Execute SyntaxDescription ExampleBreak Syntax BreakspecCustomername ExamplesSkip n Clear Syntax HistoryArgument Column SyntaxOption Break Column Compute Display TitleHeading headingtext ColumnnameFormat formatstring Date-Time Format Strings for the Column Statement Character DescriptionChar Null ? Type Length ColnameNot Null INT Sysdate OrderinfoAmount FLD Column TitleNEW Title ComputeAVG MAX MIN SUM Count VariablenameDefine Syntax ValueColposition DisplayvalueCOL columnnumber @columnnameEdit Syntax Exit Exit or Quit SyntaxRelated Statements 10 GET Syntax Isql GET query.sqlIsql RUN Help Commandsclauses Help SyntaxHistory Syntax Orderstate LotlocationFollowing example illustrates usage of the History statement From HostcommandHost or SH or Syntax List Syntax Quit or Exit Syntax 16 RUN SyntaxQuit Isql HistorySave Syntax 18 SET SyntaxPagesize LinesizePagesize numberlines Connection databasename Default Transaction Isolation Level isolationlevelIsql Break on Isql Select TBL from Systables TBL TBLShow Syntax Is Default ? Spool SyntaxFilename on Database ConnectionsStart Syntax Argument …Isql Spool STK on Isql Spool OFFNull ? Type Length Colname Not Null INT Not Null VarcharDate TablenameType Length Colname Null ? Title Syntax Left Center Right COL nText DoubleIsql Clear Title Isql and Tools FairCom Corporation Data Load Utility dbload IntroductionDbload Command Line Syntax CommandsfilePrerequisites for Dbload OptionsData File Formats Data Load Utility dbloadCommands File Variable Length RecordsFixed Length Records Next RecordDefine Record Statement Char Short Long Float DoubleFor Each Statement NullExample 4-1 Sample dbload commands files ExamplesPosition not specified for fixed length record Compilation ErrorsRecord name redefined Fatal Errors Isql and Tools FairCom Corporation Data Unload Utility dbdump Prerequisites for DbdumpDbdump Command Line Syntax Data Unload Utility dbdump Short Long Float DoubleFor Record Statement Define Record custrec of Fixed Length 37 AS Isql and Tools FairCom Corporation Schema Export Utility dbschema Username.procedurename OutfileUsername.tablename Username.triggernameSchema Export Utility dbschema DbschemaImport Begin ENDIsql and Tools FairCom Corporation Tutorial Source Code Commit Work Select * from Custmast Delete from CustmastVARCHAR6 IntegerMoney Tutorial Source Code Commit Work Delete from CustmastImdesc VARCHAR48 Select * from orderlist Select * from orderitems Isql and Tools FairCom Corporation Symbols Index-iIsql Index-ii FairCom CorporationIndex Index-iii FairCom Corporation