다음을 통해 공유


SQLTables

적용 대상: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

SQLTable은 정적 서버 커서에서 실행할 수 있습니다. 변경 가능한(동적 또는 키 집합) 커서에서 SQLTable을 실행하려고 하면 커서 형식이 변경되었음을 나타내는 SQL_SUCCESS_WITH_INFO 반환됩니다.

SQLTables는 CatalogName 매개 변수가 SQL_ALL_CATALOGS 다른 모든 매개 변수에 기본값(NULL 포인터)이 포함된 경우 모든 데이터베이스의 테이블을 보고합니다.

사용 가능한 카탈로그, 스키마 및 테이블 형식을 보고하기 위해 SQLTable은 빈 문자열(길이가 0인 바이트 포인터)을 특별히 사용합니다. 빈 문자열은 기본값이 아닙니다(NULL 포인터).

SQL Server Native Client ODBC 드라이버는 CatalogName 매개 변수 Linked_Server_Name.Catalog_Name의 두 부분으로 구성된 이름을 수락하여 연결된 서버의 테이블에 대한 보고 정보를 지원합니다.

SQLTables는 이름이 TableName과 일치하고 현재 사용자가 소유한 테이블에 대한 정보를 반환합니다.

SQLTable 및 테이블 반환 매개 변수

문 특성 SQL_SOPT_SS_NAME_SCOPE SQL_SS_NAME_SCOPE_TABLE 기본값이 아닌 SQL_SS_NAME_SCOPE_TABLE_TYPE 값을 가지면 SQLTable은 테이블 형식에 대한 정보를 반환합니다. SQLTables에서 반환된 결과 집합의 열 4에 있는 테이블 형식에 대해 반환되는 TABLE_TYPE 값은 TABLE TYPE입니다. SQL_SOPT_SS_NAME_SCOPE 대한 자세한 내용은 SQLSetStmtAttr을 참조하세요.

테이블, 뷰 및 동의어는 테이블 형식에서 사용하는 네임스페이스와 구별되는 공통 네임스페이스를 공유합니다. 이름이 같은 테이블과 뷰를 가질 수는 없지만 동일한 카탈로그 및 스키마에 테이블과 테이블 형식이 같은 테이블이 있을 수 있습니다.

테이블 반환 매개 변수에 대한 자세한 내용은 ODBC(테이블 반환 매개 변수)를 참조하세요.

예시

// Get a list of all tables in the current database.  
SQLTables(hstmt, NULL, 0, NULL, 0, NULL, 0, NULL,0);  
  
// Get a list of all tables in all databases.  
SQLTables(hstmt, (SQLCHAR*) "%", SQL_NTS, NULL, 0, NULL, 0, NULL,0);  
  
// Get a list of databases on the current connection's server.  
SQLTables(hstmt, (SQLCHAR*) "%", SQL_NTS, (SQLCHAR*)"", 0, (SQLCHAR*)"",  
    0, NULL, 0);  

참고 항목

SQLTables 함수
ODBC API 구현 정보