odbc_tables

함수

(PHP 4, PHP 5, PHP 7, PHP 8)

odbc_tables — 특정 데이터 소스에 저장된 테이블 이름 목록 가져오기


설명
odbc_tables(
    resource $odbc,
    ?string $catalog = null,
    ?string $schema = null,
    ?string $table = null,
    ?string $types = null
): resource|false

요청된 범위의 모든 테이블을 나열합니다.

한정자, 소유자 및 테이블 유형의 열거를 지원하기 위해 catalog, schema, table 및 table_type에 대해 다음과 같은 특수 의미 체계를 사용할 수 있습니다.

  • catalog가 단일 퍼센트 문자(%)이고 schema와 table이 빈 문자열인 경우 결과 집합에는 데이터 소스에 대한 유효한 한정자 목록이 포함됩니다. (TABLE_QUALIFIER 컬럼을 제외한 모든 컬럼은 NULL을 포함한다.)
  • schema가 단일 퍼센트 문자(%)이고 catalog와 table이 빈 문자열인 경우 결과 집합에는 데이터 원본에 대한 유효한 소유자 목록이 포함됩니다. (TABLE_OWNER 컬럼을 제외한 모든 컬럼은 NULL을 포함한다.)
  • table_type이 단일 퍼센트 문자(%)이고 catalog, schema 및 table이 빈 문자열인 경우 결과 세트에는 데이터 소스에 대한 유효한 테이블 유형 목록이 포함됩니다. (TABLE_TYPE 컬럼을 제외한 모든 컬럼은 NULL을 포함한다.)

매개변수
odbc
ODBC 연결 식별자, 자세한 내용은 odbc_connect()를 참조하십시오.
catalog
카탈로그(ODBC 2 용어의 '한정자').
schema
스키마(ODBC 2 용어의 '소유자'). 이 매개변수는 다음과 같은 검색 패턴을 허용합니다. %는 0개 이상의 문자와 일치하고 _는 단일 문자와 일치합니다.
table
이름. 이 매개변수는 다음과 같은 검색 패턴을 허용합니다. %는 0개 이상의 문자와 일치하고 _는 단일 문자와 일치합니다.
types
table_type이 빈 문자열이 아닌 경우 관심 유형에 대해 쉼표로 구분된 값 목록을 포함해야 합니다. 각 값은 작은따옴표(')로 묶거나 인용하지 않을 수 있습니다. 예: 'TABLE','VIEW' 또는 TABLE, VIEW. 데이터 소스가 지정된 테이블 유형을 지원하지 않는 경우 odbc_tables()는 해당 유형에 대한 결과를 반환하지 않습니다.

반환 값

정보가 포함된 ODBC 결과 식별자를 반환하거나 실패 시 false를 반환합니다.

결과 집합에는 다음 열이 있습니다.

  • TABLE_CAT
  • TABLE_SCHEM
  • TABLE_NAME
  • TABLE_TYPE
  • REMARKS

드라이버는 추가 열을 보고할 수 있습니다.

결과 집합은 TABLE_TYPE, TABLE_CAT, TABLE_SCHEM 및 TABLE_NAME별로 정렬됩니다.


변경 로그
버전 설명
8.1.0 schema,table 및 types은 이제 null을 허용합니다.

Examples

예제 #1 카탈로그의 테이블 나열

                  
<?php
$conn = odbc_connect($dsn, $user, $pass);
$tables = odbc_tables($conn, 'SalesOrders', 'dbo', '%', 'TABLE');
while (($row = odbc_fetch_array($tables))) {
    print_r($row);
    break; // further rows omitted for brevity
}
?>

위의 예는 다음과 유사한 결과를 출력합니다.

Array
(
    [TABLE_CAT] => SalesOrders
    [TABLE_SCHEM] => dbo
    [TABLE_NAME] => Orders
    [TABLE_TYPE] => TABLE
    [REMARKS] =>
)

기타

PHP

웹학교

참조