- SQL iQuery - RUNiQRY CL Command
- CSV() - Read and Parse Comma Separated Values File
- CSV_VAL() Extract CSV Column Value
- CSV_XXXX() Extract CSV Column Value as xxxx
- CSV_COUNT - Retrieve Field Count
- ObjExist - Check Object Exits
- DTAARA - Data Area
- encode_URL Encode URL for the Web
- encode_TAG Encode HTML TAG Content
- FLDLIST - List the Fields of a Table
- FROMHEX - Fold 2-hex Chars into 1 Char
- GET CPUCNT, CURLIB, ENV, SRLNBR, SYSNAME
- MD5_HASH - UDF - Return MD5 Hash
- ifsStat - Get IFS File Attributes
- ifsExists - Check if IFS File Exists
- ifsFile - Query Contents of IFS Text File
- ifsDIR - List IFS Directory Entires
- DEPFILE - List Dependent Database Relations
- JOB - Get Job Name Component
- Job_ATTR - Job Attributes
- JOB_DATE Retrieve the Job Date
- JOBLOG - Write Message to Joblog
- Library List UDF and Procedures
- MBRLIST - Member List
- MCHINFO Machine Type and Model Number and OS version
- OSVER and OSVRM Get IBM i Version/Release
- PrintPDF - Print a PDF to a PDF Compatible Printer
- CPYTOPDF - Copy SPOOLED File to PDF file
- OBJ_LIST List Object in a Library
- LIB_LIST List Descriptions of Libraries on the Library List
- OBJ_EXPORTS List Exported Items from an Object
- OBJ_STRUCT Retrieve Objects Components
- RTVCMDD Retrieve Command Definition
- RTVJOBA - Retrieve Job Attributes
- RTVJOBD - Retrieve Job Description
- RTVLASTSPLF - Retrieve ID of Last SPOOLED File for this Job
- RTVxxx - Retrieve Various Objects Description Table Functions
- WATCHLIST - List Current Watches
- Polymorphic Qualified Name Syntax
Using IBM i? Need to create Excel, CSV, HTML, JSON, PDF, SPOOL reports? Learn more about the fastest and least expensive tool for the job: SQL iQuery.
Read CSV File
The iQuery.CSV() UDTF reads an IFS text file that contains Comma Separated Values and returns that contant to the caller. The data can be extracted using the provided iQuery.csv_val() function or one of the variations of it to return decimal, text, date/time or integer content.
The maximum width of a CSV result cannot exceed about 8k (8192 bytes).
Parameters
iQuery.csv( 'ifs-file-and-path', [number of header rows: dft 1], [ dump column names] )
The IFS file and path is a classic IFS file name with the fully qualified path name. If no path is specified and only a file name is used, it uses the current working directory to locate the file. It is normally recommended to fully qualify the file name to the path in which it is located.
The optional number of header rows indicates to the UDTF how many row were used to generate the CSV column headings (if any). By default 1 row is assumed. The column headings may be used to reference the columns using the CSV_VAL() and related functions. If no column headings are included in the CSV file, then specify 0 for this parameter, and refer to the columns on the CSV_VAL() function by the relative column number only.
The optional dump column name parameter may be used to generate a list of CSV column names to the joblog. This can help with debugging certain files when the column name is not working as expected. Typically this is rarely used an is only inteded for debug purposes.
| Column Name |
System Column Name |
Data Type | Description |
| DATA | DATA | VARCHAR(8192) | The CSV data is parsed and returned as a fixed width record. Use this columin the CSV_VAL() UDF to extract the data from the result set using either column names or relative column number. |
Example
select csv_val(data,'custno'), csv_val(data,'custName') from iQuery.csv('/home/pickles/customers.csv');
In this example, the CUSTNO and CUSTNAME columns from the CSV file named CUSTOMERS.CSV are returned. The file is located in folder /home/pickles on the IFS. The data is returned as text. To return the CUSTNO colum as numeric, use CSV_DEC or CSV_INT functions.