IBM Books

Net.Data 참조서

플랫 파일 인터페이스

플랫 파일 인터페이스는 대부분의 플랫폼상에서 DB2에 대해 사전구성되는 언어 환경입니다. Net.Data 매크로에 있는 함수들을 사용하여 플랫 파일에 자료를 저장할 수 있을 뿐만 아니라, 플랫 파일 소스(플레인 텍스트) 로부터 자료를 열고, 읽고, 조작할 수 있습니다.

플랫 파일 인터페이스 분리문자

성능을 향상시키려면, 플랫 파일에 있는 일련의 SQL 요청으로부터 Net.Data을 표양식으로 출력시키면 됩니다. SQL 요청을 다시 발행하는 대신, 일련의 요청에서 플랫 파일을 검색할 수 있습니다.

Net.Data 플랫 파일은 Net.Data 테이블로부터 작성할 수 있고, Net.Data 테이블은 플랫 파일로부터 작성할 수 있습니다. 테이블과 플랫 파일간 변환을 하려면, 테이블내 컬럼과 플랫 파일내 레코드 사이의 대응을 정의해야 합니다. 분리문자는 플랫 파일내 레코드 부분들의 분리 방법과 테이블내 컬럼으로의 대응 방법, 테이블내 컬럼이 플랫 파일내 레코드로 대응되는 방식 등을 정의하는 방법을 제공합니다.

다음과 같은 두 가지 분리문자가 있습니다.

개행 문자(ASCIITEXT)
사용자 테이블이 한 컬럼으로 구성되어 있는 경우 이 변환을 사용하십시오. Net.Data는 해당 플랫 파일의 각 레코드를 테이블내 단일 행으로 대응시킵니다. 이런 경우, 플랫 파일내 레코드들을 분리시키는 정규 개행 문자가 유일하게 사용되는 분리문자입니다.

개행 문자 및 분리문자 문자열(DELIMITED)
사용자 테이블이 여러 컬럼으로 구성되어 있는 경우이 변환을 사용하십시오. Net.Data가 테이블내 행으로부터 플랫 파일 레코드를 작성하는 경우, 항목간 분리자로서 분리문자 문자열을 둡니다. Net.Data가 플랫 파일로부터 테이블을 재작성하는 경우, 분리문자 문자열을 사용하여 테이블내 컬럼에 둘 각 행의 문자열을 결정합니다. 이런 경우, 정규 개행 문자는 테이블내 행에 해당하는 플랫 파일내 레코드들을 분리시키고, 분리문자 문자열은 단일 레코드내 항목들을 분리시킵니다.

DTWF_SEARCH 함수를 사용하여 Net.Data 테이블로부터 작성된 플랫 파일에 보유되어 있는 특정 레코드들을 검색할 수 있습니다. Net.Data 테이블에 있는 행으로서 플랫 파일에 문자열이 들어 있는 모든 레코드를 리턴하려면 DTWF_SEARCH에 문자열을 지정하십시오.

플랫 파일 인터페이스 함수

DTWF_APPEND

목적


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

테이블 변수 목차를 파일 끝에 기록합니다.

구문

매개변수

표 51. DTWF_APPEND 매개변수
자료 유형 매개변수 사용 설명
문자열 filename IN 테이블 변수의 목차가 추가되는 파일명.
문자열 transform IN 파일의 형식은 다음과 같습니다.

  • ASCIITEXT - 컬럼 값들 사이의 개행 문자로 테이블을 파일에 쓰고, 분리문자 매개변수를 무시합니다.

  • DELIMITED - 분리문자 매개변수에 지정된 분리문자로 테이블을 파일에 씁니다.
문자열 delimiter IN 값의 끝을 표시하는 문자열. 이 매개변수는 대소문자를 구분합니다. transform이 ASCIITEXT인 경우 무시됩니다.
문자열 table IN 레코드를 읽어 들이는 테이블 변수.
정수 retry IN 파일을 즉시 첨부할 수 없는 경우, 재시도 횟수. 생략시 값은 재시도를 하지 않는 것입니다.
정수 rows IN 첨부할 테이블의 최대 행 수. 생략시 값은 모든 행을 첨부하는 것입니다. 0을 지정하면 모든 행을 첨부합니다.

예

예1: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_APPEND(myFile, "DELIMITED", " ;", myTable)

예2: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_APPEND(myFile, "ASCIITEXT", " ;", myTable)

예3: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_APPEND(myFile, "ASCIITEXT", " ;", myTable, "0", "10")

DTWF_CLOSE

목적


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

DTWF_OPEN로 열린 파일을 닫습니다.

구문

매개변수

표 52. DTWF_CLOSE 매개변수
자료 유형 매개변수 사용 설명
문자열 filename IN 닫을 파일명. 파일이 닫힐 때 전체 경로명이 리턴됩니다.
정수 retry IN 파일을 즉시 닫을 수 없는 경우 재시도되는 횟수. 생략시 값은 재시도를 하지 않는 것입니다.

예

예1: 

@DTWF_CLOSE(myFile, 5)

DTWF_DELETE

목적


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

파일에서 레코드를 삭제합니다. (빈 파일은 삭제하지 않습니다.)

구문

매개변수

표 53. DTW_DELETE 매개변수
자료 유형 매개변수 사용 설명
문자열 filename IN 레코드를 삭제할 파일명.
문자열 transform IN 파일의 형식은 다음과 같습니다.

  • ASCIITEXT - 컬럼 값들 사이의 개행 문자로 테이블을 파일에 쓰고, 분리문자 매개변수를 무시합니다.

  • DELIMITED - 분리문자 매개변수에 지정된 분리문자로 테이블을 파일에 씁니다.
문자열 delimiter IN 값의 끝을 표시하는 문자열. 이 매개변수는 대소문자를 구분합니다. transform이 ASCIITEXT인 경우 무시됩니다.
정수 retry IN 파일을 즉시 삭제할 수 없는 경우 재시도되는 횟수. 생략시 값은 재시도를 하지 않는 것입니다.
정수 rows IN 삭제할 최대 행 수. 생략시 값은 모든 행을 삭제하는 것입니다. 0을 지정하면 모든 행이 삭제됩니다.
정수 startrow IN 삭제를 시작할 행 번호. 값 1은 첫번째 행에서 삭제가 시작됨을 의미합니다. 이 값이 파일의 전체 행 수보다 큰 경우, 마지막 레코드로 값이 변경되고 오류가 발생합니다. 생략시 값은 1에서 시작하는 것입니다.

예

예1: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
   myWait = "5000"
   myRows = "2"
%}
@DTWF_DELETE(myFile, "Delimited", "|", myWait, myRows)

예2: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
   myStart = "1"
   myRows = "2"
%}
@DTWF_DELETE(myFile, "Asciitext", "|", "0", myRows, myStart)

DTWF_INSERT

목적


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

레코드를 파일에 삽입합니다.

구문

매개변수

표 54. DTWF_INSERT 매개변수
자료 유형 매개변수 사용 설명
문자열 filename INOUT 레코드를 삽입할 파일명. 파일의 전체 경로명이 리턴됩니다.
문자열 transform IN 파일의 형식은 다음과 같습니다.

  • ASCIITEXT - 컬럼 값들 사이의 개행 문자로 테이블을 파일에 쓰고, 분리문자 매개변수를 무시합니다.

  • DELIMITED - 분리문자 매개변수에 지정된 분리문자로 테이블을 파일에 씁니다.
문자열 delimiter IN 값의 끝을 표시하는 문자열. 이 매개변수는 대소문자를 구분합니다. transform이 ASCIITEXT인 경우 무시됩니다.
문자열 table IN 테이블에 레코드를 삽입할 테이블 변수.
정수 retry IN 파일에 즉시 기록할 수 없는 경우 재시도되는 횟수. 생략시 값은 재시도를 하지 않는 것입니다.
정수 rows IN 테이블로부터 삽입할 최대 행 수. 생략시 값은 모든 행을 삽입하는 것입니다. 값 0은 모든 행을 삽입합니다.
정수 startrow IN 삽입을 시작할 행 번호. 1을 지정하면 첫번째 행에서 삽입이 시작됩니다. 이 값이 파일의 전체 행 수보다 큰 경우, 마지막 레코드로 값이 변경되고 오류가 발생합니다. 생략시 값은 1에서 시작하는 것입니다.

예

예1: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
   myWait = "3000"
%}
@DTWF_INSERT(myFile, "Delimited", "|", myTable, myWait)

예2: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
   myStart = "1"
   myRows = "2"
%}
@DTWF_INSERT(myFile, "Asciitext", "|", myTable, "0", myRows, myStart)

DTWF_OPEN

목적


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

파일을 엽니다. DTWF_OPEN을 호출하지 않고도 DTWF_READ 및 DTWF_WRITE 같은 함수들이 자동으로 파일을 열도록 하기 위해 DTWF_CLOSE로 파일이 닫힐 때까지 파일은 연 상태로 되어 있습니다.

구문

매개변수

표 55. DTWF_OPEN 매개변수
자료 유형 매개변수 사용 설명
문자열 filename INOUT 열 파일명. 파일의 경로와 이름이 리턴됩니다.
문자열 mode IN 요청되는 액세스 유형은 다음과 같습니다.

  • r - 읽기 위해 기존의 파일을 엽니다.

  • w - 쓰기 위해 파일을 작성합니다. (같은 이름의 파일이 있는 경우 기존의 파일이 파괴됩니다.)

  • a - 첨부할 파일을 엽니다. 해당 파일이 없는 경우 Net.Data는 파일을 작성합니다.

  • r+ - 읽기 및 쓰기를 위해 기존의 파일을 엽니다.

  • w+ - 읽기 및 쓰기를 위해 파일을 작성합니다. (같은 이름의 파일이 있는 경우 기존의 파일이 파괴됩니다.)

  • a+ - 읽기 또는 첨부를 위해 첨부 모드로 파일을 엽니다. 해당 파일이 없는 경우 Net.Data는 파일을 작성합니다.
정수 retry IN 파일을 즉시 열 수 없는 경우 재시도되는 횟수. 생략시 값은 재시도를 하지 않는 것입니다.

예

예1: 

%DEFINE {
  myFile = "c:/private/myfile"
  myMode = "r+"
%}
@DTWF_OPEN(myFile, myMode, "1000")

DTWF_READ

목적


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

파일로부터 테이블 변수로 레코드를 읽습니다.

구문

매개변수

표 56. DTWF_READ 매개변수
자료 유형 매개변수 사용 설명
문자열 filename INOUT 테이블 변수로 레코드를 읽을 파일명. 파일의 경로와 이름이 리턴됩니다.
문자열 transform IN 파일의 형식은 다음과 같습니다.

  • ASCIITEXT - 컬럼 값들 사이의 개행 문자로 테이블을 파일에 쓰고, 분리문자 매개변수를 무시합니다.

  • DELIMITED - 분리문자 매개변수에 지정된 분리문자로 테이블을 파일에 씁니다.
문자열 delimiter IN 값의 끝을 표시하는 문자열. 이 매개변수는 대소문자를 구분합니다. transform이 ASCIITEXT인 경우 무시됩니다.
문자열 table IN 파일 레코드가 읽힐 테이블 변수.
정수 retry IN 파일을 즉시 읽을 수 없는 경우 재시도되는 횟수. 생략시 값은 재시도를 하지 않는 것입니다.
정수 rows IN 테이블로 읽어들일 파일 레코드의 최대 수. 생략시 값은 모든 레코드를 읽거나, 테이블이 꽉 찰때까지 읽는 것입니다. 0은 파일 끝까지 읽는 것을 의미합니다. 결과 테이블의 행 수가 리턴됩니다.
정수 startrow IN 읽기를 시작할 파일의 레코드. 생략시 값은 첫번째 레코드에서 읽기 시작하는 것입니다.
정수 columns OUT 테이블의 컬럼 수를 리턴합니다.

예

예1: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
  myWait = "1000"
%}
@DTWF_READ(myFile, "DELIMITED", ";", myTable, myWait)

예2: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
  myWait = "0"
  myRows = "0"
  myStartrow = "1"
  myColumns = ""
%}
@DTWF_READ(myFile, "DELIMITED", ";", myTable, myWait, myRows,
             myStartrow, myColumns)

예3: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_READ(myFile, "ASCIITEXT", ";", myTable, myColumns)
@DTW_TB_TABLE(myTable,"BORDER","")

DTWF_REMOVE

목적


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

전체 파일을 삭제합니다.

구문

매개변수

표 57. DTW_REMOVE 매개변수
자료 유형 매개변수 사용 설명
문자열 filename INOUT 삭제할 파일명. 파일의 경로와 이름이 리턴됩니다.
정수 retry IN 파일을 즉시 삭제할 수 없는 경우 재시도되는 횟수. 생략시 값은 재시도를 하지 않는 것입니다.

예

예1: 

%DEFINE myFile = "c:/private/myfile"
@DTWF_REMOVE(myFile)

예2: 

%DEFINE {
  myFile = "c:/private/myfile"
  myWait = "2000"
%}
@DTWF_REMOVE(myFile, myWait)

DTWF_SEARCH

목적


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

테이블 변수로 문자열 탐색 결과를 리턴합니다.

구문

매개변수

표 58. DTWF_SEARCH 매개변수
자료 유형 매개변수 사용 설명
문자열 filename INOUT 탐색할 파일명. 발견된 파일의 경로와 이름이 리턴됩니다.
문자열 transform IN 파일의 형식은 다음과 같습니다.

  • ASCIITEXT - 컬럼 값들 사이의 개행 문자로 테이블을 파일에 쓰고, 분리문자 매개변수를 무시합니다.

  • DELIMITED - 분리문자 매개변수에 지정된 분리문자로 테이블을 파일에 씁니다.
문자열 delimiter IN 값의 끝을 표시하는 문자열. 이 매개변수는 대소문자를 구분합니다. transform이 ASCIITEXT인 경우 무시됩니다.
문자열 table IN 탐색 결과가 위치할 테이블 변수. transform이 DELIMITED인 경우 다음과 같은 3개 컬럼이 리턴됩니다.

  1. 일치가 발견된 행.

  2. 일치가 발견된 컬럼.

  3. 파일로부터의 일치 컬럼.
문자열 searchFor IN 탐색할 문자들의 문자열.
정수 retry IN 파일을 즉시 탐색할 수 없는 경우 재시도되는 횟수. 생략시 값은 재시도를 하지 않는 것입니다.
정수 rows IN 테이블로 읽어들일 최대 행 수. 생략시 값은 모든 행을 읽거나, 테이블이 꽉찰 때까지 읽는 것입니다. 0을 지정하면 파일 끝까지 읽습니다. 이 매개변수에 의해 결과 테이블의 행 수가 리턴됩니다.
정수 startrow IN 탐색을 시작할 파일의 레코드. 생략시 값은 1입니다. 즉, 첫번째 레코드에서 탐색을 시작합니다.

예

예1: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
  myWait = "1000"
  mySearch = "0123456789abcdef"
@DTWF_SEARCH(myFile, "DELIMITED", ";",
               myTable, mySearch, myWait)

예2: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
  mySearch = "answer:"
  myWait = "0"
  myRows = "0"
  myStartrow = "1"
%}
@DTWF_SEARCH(myFile, "DELIMITED", ";", myTable,
               mySearch, myWait, myRows, myStartrow)

DTWF_UPDATE

목적


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

테이블 변수로부터 파일 레코드를 갱신합니다.

구문

매개변수

표 59. DTWF_UPDATE 매개변수
자료 유형 매개변수 사용 설명
문자열 filename IN 테이블 변수로부터 레코드가 갱신되는 파일명.
문자열 transform IN 파일의 형식은 다음과 같습니다.

  • ASCIITEXT - 컬럼 값들 사이의 개행 문자로 테이블을 파일에 쓰고, 분리문자 매개변수를 무시합니다.

  • DELIMITED - 분리문자 매개변수에 지정된 분리문자로 테이블을 파일에 씁니다.
문자열 delimiter IN 값의 끝을 표시하는 문자열. 이 매개변수는 대소문자를 구분합니다. transform이 ASCIITEXT인 경우 무시됩니다.
문자열 table IN 파일 레코드가 갱신될 해당 테이블 변수.
정수 retry IN 파일에 즉시 기록할 수 없는 경우 재시도되는 횟수. 생략시 값은 재시도를 하지 않는 것입니다.
정수 rows IN 테이블로부터 갱신될 최대 레코드 수. 생략시 값은 모든 레코드를 갱신하는 것입니다. 0은 파일내 모든 행을 갱신하는 것을 의미합니다.
정수 startrow IN 갱신할 첫번째 파일 레코드. 생략시 값은 1입니다. 즉, 파일의 시작 부분에서 갱신이 시작됩니다. 이 값이 파일의 전체 레코드 수보다 큰 경우, 파일의 마지막 레코드 번호를 표시하도록 값이 변경되고 오류가 발생합니다.

예

예1: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
   myWait = "1500"
   myRows = "2"
%}
@DTWF_UPDATE(myFile, "Delimited", "|", myTable, myWait, myRows)

예2: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
   myStart = "1"
   myRows = "2"
%}
@DTWF_UPDATE(myFile, "Asciitext", "|", myTable, "0", myRows, myStart)

DTWF_WRITE

목적


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X
X X X

테이블 변수 목차를 파일에 기록합니다.

구문

매개변수

표 60. DTWF_WRITE 매개변수
자료 유형 매개변수 사용 설명
문자열 filename IN 테이블 변수의 레코드를 기록할 파일명. 파일의 경로와 이름이 리턴됩니다.
문자열 transform IN 파일의 형식은 다음과 같습니다.

  • ASCIITEXT - 컬럼 값들 사이의 개행 문자로 테이블을 파일에 쓰고, 분리문자 매개변수를 무시합니다.

  • DELIMITED - 분리문자 매개변수에 지정된 분리문자로 테이블을 파일에 씁니다.
문자열 delimiter IN 값의 끝을 표시하는 문자열. 이 매개변수는 대소문자를 구분합니다. transform이 ASCIITEXT인 경우 무시됩니다.
문자열 table IN 행을 파일로 반출(export)하는 데 사용되는 테이블 변수.
정수 retry IN 파일에 즉시 기록할 수 없는 경우 재시도되는 횟수. 생략시 값은 재시도를 하지 않는 것입니다.
정수 rows IN 기록할 파일 레코드의 최대 수. 생략시 값은 전체 테이블을 쓰는 것입니다. 0은 파일 끝에 모든 레코드를 쓰는 것을 의미합니다.
정수 startrow IN 파일 내에서 쓰기를 시작할 레코드 번호. 생략시 값은 1입니다. 즉, 첫번째 레코드에서 시작합니다. 파일 범위를 넘어서는 값이 지정되는 경우, 파일의 마지막 행에 오류가 발생합니다.

예

예1: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_WRITE(myFile, "DELIMITED", ";", myTable)

예2: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_WRITE(myFile, "ASCIITEXT", ";", myTable, "5000")

예3: 

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_WRITE(myFile, "ASCIITEXT", ";", myTable, "5000", "10", "50")

[ 페이지의 맨 위 | 이전 페이지 | 다음 페이지 | 목차 | 색인 ]