GET_SCHEMA_NAME_ONLY

유효 기간

추출 및 복제

설명

GET_SCHEMA_NAME_ONLY 함수를 사용하여 처리 중인 레코드와 연관된 소스 또는 대상 객체의 카탈로그, 컨테이너(해당하는 경우) 또는 객체 이름이 아닌 소유자 이름(예: 스키마)을 검색합니다. 이 함수는 DML 및 DDL 작업에 적합합니다.

테이블의 전체 이름을 반환하려면 다음을 참조하십시오.

GET_TABLE_NAME

비테이블 객체의 전체 이름(예: 사용자, 뷰 또는 <index>)을 반환하려면 다음을 참조하십시오.

GET_OBJECT_NAME

정규화되지 않은 테이블 또는 객체 이름만 반환하려면 다음을 참조하십시오.

GET_TABLE_NAME_ONLY

GET_OBJECT_NAME_ONLY

테이블 또는 객체 이름의 다른 부분을 반환하려면 다음을 참조하십시오.

GET_CATALOG_NAME_ONLY

데이터베이스 객체 이름은 대소문자를 포함하여 호스팅 데이터베이스에 정의된 대로 정확하게 반환됩니다.

구문

#include "usrdecs.h"
short result_code;
env_value_def env_value;
ERCALLBACK (GET_SCHEMA_NAME_ONLY, &env_value, &result_code);

버퍼

typedef struct
{
char *buffer;
long max_length;
long actual_length;
short value_truncated;
short index;
short source_or_target;
} env_value_def;

입력

<buffer>

반환된 스키마 이름을 수락할 버퍼에 대한 포인터입니다. 이름이 널로 종료되었습니다.

<max_length>

스키마 이름을 수락할 할당된 버퍼의 최대 길이입니다. NULL 종료 문자열로 반환됩니다.

<source_or_target>

다음 중 하나는 소스 또는 대상 스키마 이름을 반환할지 여부를 나타냅니다.

EXIT_FN_SOURCE_VAL
EXIT_FN_TARGET_VAL

출력

<buffer>

널로 종료된 정규화된 스키마 이름입니다.

User Exit의 문자 세션이 SET_SESSION_CHARSET로 운영 체제의 기본 문자 집합이 아닌 다른 값으로 설정되면(ucharset.h 파일의 ULIB_CS_DEFAULT에 정의됨) 스키마 이름이 세션 문자 집합에서 해석됩니다.

<actual_length>

반환된 이름의 문자열 길이입니다. 실제 길이에는 널 종료자가 포함되지 않습니다.

<value_truncated>

값이 잘렸는지 여부를 나타내는 플래그(0 또는 1)입니다. 스키마 이름과 널 종료자의 길이가 최대 버퍼 길이를 초과하는 경우 잘립니다.

반환 값

EXIT_FN_RET_INVALID_COLUMN
EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_OK