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

Suresh Thalamati commented on DERBY-2527:
-----------------------------------------

Thanks Laura. My comments are below for the questions you posted. 

1) 
>> The phrase "performs single inserts" ... should that be "performs single row
>>inserts" ??? 

yes. "performs single row inserts" is better. 


2)
>>In the list of arguments, there is this text on many of the parameters 
>>"Passing a null will result in an error." 
>>The current text might be confusing since other parameters allow a NULL 
>>value. 
>>I propose that we change it to: 
>> "Omitting this parameter or passing a NULL value will result in a error" 
>>>Is this new phrasing accurate? 

Omitting a parameter will result an error for all the system procedures. I think
it is not necessary to explicitly say that for some cases. 
 

3) 
>> I'm confused about the import examples. Are the insertColumns and
>>columnIndexes arguments optional? 

No. There are required arguments when using SYSCS_UTIL.SYSCS_IMPORT_DATA(..)
or SYSCS_UTIL.SYSCS_IMPORT_DATA_LOBS_FROM_EXTFILE(...)  .

They are not arguments for  SYSCS_UTIL.SYSCS_IMPORT_TABLE() and 
SYSCS_UTIL.SYSCS_IMPORT_TABLE_LOBS_FROM_EXTFILE(..)

My understanding of the doc in the tools guide is, user
follows the syntax defined for the procedures and finds the explanation for 
the arguments in the "Arguments to import procedure page"(
http://db.apache.org/derby/docs/10.2/tools/rtoolsimport64241.html) depending 
on what procedure he/she is using. 


>>If so, then we should state that in the topic
>>the describes the arguments. If not, then the examples need to be
>>updated. Please advise :-) 

If you find any examples, that are not correct. Please let me know, 
I will verify them. 


> Add documentation for  import/export  of LOBS and other binary data types. 
> ---------------------------------------------------------------------------
>
>                 Key: DERBY-2527
>                 URL: https://issues.apache.org/jira/browse/DERBY-2527
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.3.0.0
>            Reporter: Suresh Thalamati
>         Assigned To: Laura Stewart
>         Attachments: iexlobs_v1.txt
>
>


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

Reply via email to