[jira] [Commented] (DERBY-5441) Misleading description of SYSCS_DIAG.SPACE_TABLE

["Kim Haase (JIRA)" <ji...@apache.org>]

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

Kim Haase commented on DERBY-5441:
----------------------------------

I'm wondering if the work on DERBY-5822 has fixed the problems described in this issue? If so, perhaps it could be linked to that issue and resolved as fixed.
                
> Misleading description of SYSCS_DIAG.SPACE_TABLE
> ------------------------------------------------
>
>                 Key: DERBY-5441
>                 URL: https://issues.apache.org/jira/browse/DERBY-5441
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.3.1.4, 10.3.2.1, 10.3.3.0, 10.4.1.3, 10.4.2.0, 10.5.1.1, 10.5.2.0, 10.5.3.0, 10.6.1.0, 10.6.2.1, 10.7.1.1, 10.8.1.2
>            Reporter: Dag H. Wanvik
>            Priority: Minor
>
> This method can take one or two arguments. If two arguments are provided the first should be the name of the SCHEMA, the second argument should be the name of the TABLE, in both cases in internal normal form, that is, capitalized unless the names were created as quoted identifiers.
> If the method takes only one argument, that argument should be the name of the TABLE. The schema will be taken to be the current default schema
> It is somewhat implicit in the docs that the table function can accept one or two arguments, I'd like this to be made clearer. In particular, doing something like:
>      SELECT * from TABLE(SYSCS_DIAG.SPACE_TABLE('APP.FOO')) AS S;
> will not give the expected result, since this means the table APP."APP.FOO", which is less than obvious.
> Also, this sentence of description is wrong, in my view:
>     "For example, use the following query to return the space usage for all of the user tables and indexes in the database:
>     
>     SELECT T2.*
>         FROM 
>             SYS.SYSTABLES systabs,
>             TABLE (SYSCS_DIAG.SPACE_TABLE(systabs.tablename)) AS T2
>         WHERE systabs.tabletype = 'T'
>     
>     where T2 is a user-specified table name that is any valid identifier."
> Note "all the user tables and indexes in the database". The correct statement would be "all the tables and indexes in the current default schema".
> If one wanted *all* user tables, the query would be:
>     SELECT T2.* 
>         FROM
>             SYS.SYSTABLES systabs, 
>             sys.sysschemas sysschemas, 
>             TABLE (SYSCS_DIAG.SPACE_TABLE(sysschemas.schemaname, systabs.tablename)) AS T2
>             WHERE systabs.tabletype = 'T' and systabs.schemaid = sysschemas.schemaid;

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira