db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Myrna van Lunteren (JIRA)" <j...@apache.org>
Subject [jira] Updated: (DERBY-391) Tools and Utilities guide does not document ij.datasource, ij.user, nor ij.password
Date Tue, 12 Jun 2007 19:16:26 GMT

     [ https://issues.apache.org/jira/browse/DERBY-391?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel

Myrna van Lunteren updated DERBY-391:

    Attachment: rtoolsijproprefshownoselectcount.html

Thx John for looking at these files. 
The double negatives did confuse me and I messed up the cut-and-paste from a command window.

I'm attaching a new patch, which addresses the issues you raised, plus which uses the appropriate
conref for the ij version message and uses correct syntax structure for a choice of literals.

Note, that I saw that in 1 more file (for ij.showErrorCode) the false | true syntax structure
was not done this way, and that in 1 other file (for ij.dataSource) the ij version number
was hardcoded. 
I corrected those 2 issues also.

> Tools and Utilities guide does not document ij.datasource, ij.user, nor ij.password
> -----------------------------------------------------------------------------------
>                 Key: DERBY-391
>                 URL: https://issues.apache.org/jira/browse/DERBY-391
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions:
>            Reporter: Myrna van Lunteren
>            Assignee: Myrna van Lunteren
>            Priority: Minor
>             Fix For:
>         Attachments: DERBY-391.diff, DERBY-391.diff2, derby391firsthalf.diff, rtoolsijpropref25589.html,
rtoolsijproprefdatasource.html, rtoolsijproprefdatasource.html, rtoolsijproprefpassword.html,
rtoolsijproprefshownoconn.html, rtoolsijproprefshownoconn.html, rtoolsijproprefshownoselectcount.html,
rtoolsijproprefshownoselectcount.html, rtoolsijproprefuser.html
> The Tools and Utilities guide documents the ij properties. 
> However, it does not have any documentation about the following properties
> ij.datasource
> ij.password
> ij.user
> I suggest something like this (but someone else should review):
> ij.dataSource
> Function
> This property allows one to specify the datasource that should be used to access the
database. When specifying a datasource, Derby does *not* use the DriverManager mechanism to
establish connections. For more information about DataSources, refer to the JDBC documentation
and to the Derby Developer's Guide, section Using Derby as a J2EE Resource Manager.
> To establish a connection using ij.dataSource, you need to use additional ij.dataSource
properties to set some additional properties:
> ij.dataSource.databaseName
> ij.dataSource.createDatabase
> Syntax 
> ij.dataSource=<datasourcename> ij.dataSource.databaseName=<databaseName>
> Example
> java -Dij.dataSource=org.apache.derby.jdbc.EmbeddedDataSource
> -Dij.dataSource.databaseName=toursDB -Dij.dataSource.createDatabase=create"
> ij.password
>   Function
>   Specifies the password used to make connections with.
>   When you connect like this, and ij creates the database, you will allways need to know
that password in order to access the database, unless you set up additional users. For more
information about authentication see the Derby Developer's Guide.
> Syntax 
> ij.pasword=password
> Example
> java -Dij.user=me -Dij.password=mine org.apache.derby.tools.ij
> See also
> ij.user; Derby Developer's Guide - Derby and Security
> ij.user
>   Function
>   Specifies the user with which connections are made by default.
>   When you connect like this, ij assumes that the database schema to be used is the same
as the username provided. However, certain database objects cannot be created until a schema
exists, i.e. until a create schema <name> has been issued, followed by a set schema
<name>, or fully qualifying the database objects to be created. If no user is specified,
no set schema has been issued, or create statements do not qualify the schema, all database
objects are assumed to be under schema 'APP'. 
> Syntax 
> ij.user=username
> Example
> java -Dij.user=me -Dij.password=mine org.apache.derby.tools.ij
> ij version 10.1
> ij> set schema finance;
> ij> select * from accounts;
> ij.password; Derby Developer's Guide - Derby and Security

This message is automatically generated by JIRA.
You can reply to this email to add a comment to the issue online.

View raw message