db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Kim Haase (JIRA)" <j...@apache.org>
Subject [jira] [Comment Edited] (DERBY-6462) Provide more information about database name and path syntax
Date Wed, 30 Apr 2014 20:47:17 GMT

    [ https://issues.apache.org/jira/browse/DERBY-6462?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13986052#comment-13986052
] 

Kim Haase edited comment on DERBY-6462 at 4/30/14 8:45 PM:
-----------------------------------------------------------

We should observe the most common terminology conventions, I think. Would it make sense to
replace "database name" with "database path name" when we talk about the syntax? For example,
suppose the "databaseName=nameOfDatabase attribute" topic began like this:

{noformat}
Specifies a database path name for a connection. You can use this attribute instead of specifying
the database name after the subprotocol.

The nameOfDatabase value can be either an absolute path name or a path name relative to derby.system.home.
For example, thisDB, databases/thisDB, and c:/databases/2014/january/thisDB can all be valid
values.

The path separator in the connection URL is a forward slash (/), even in Windows path names.
The nameOfDatabase value cannot contain a colon (:), except for the colon after the drive
name in a Windows path name.
{noformat}


was (Author: chaase3):
We should observe the most common terminology conventions, I think. Would it make sense to
replace "database name" with "database path name" when we talk about the syntax? For example,
suppose the "databaseName=nameOfDatabase attribute" topic began like this:

Specifies a database path name for a connection. You can use this attribute instead of specifying
the database name after the subprotocol.

The nameOfDatabase value can be either an absolute path name or a path name relative to derby.system.home.
For example, thisDB, databases/thisDB, and c:/databases/2014/january/thisDB can all be valid
values.

The path separator in the connection URL is a forward slash (/), even in Windows path names.
The nameOfDatabase value cannot contain a colon (:), except for the colon after the drive
name in a Windows path name.

> Provide more information about database name and path syntax
> ------------------------------------------------------------
>
>                 Key: DERBY-6462
>                 URL: https://issues.apache.org/jira/browse/DERBY-6462
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 10.11.0.0
>            Reporter: Dag H. Wanvik
>            Assignee: Kim Haase
>         Attachments: DERBY-6462-2.diff, DERBY-6462-2.stat, DERBY-6462-2.zip, DERBY-6462-3.diff,
DERBY-6462-3.zip, DERBY-6462.diff, DERBY-6462.stat, DERBY-6462.zip
>
>
> Except for initial Windows drive letters (e.g. K:/derby), colons break Derby.
> Windows can't have colons in directory of file names, so this is a Unix issue.
> [http://msdn.microsoft.com/en-us/library/aa365247%28VS.85%29.aspx#file_and_directory_names]



--
This message was sent by Atlassian JIRA
(v6.2#6252)

Mime
View raw message