다음을 통해 공유

카탈로그 함수 사용

  • 아티클

적용 대상: SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

Important

SNAC(SQL Server Native Client)는 다음과 함께 제공되지 않습니다.

  • SQL Server 2022(16.x) 이상 버전
  • SQL Server Management Studio 19 이상 버전

SQLNCLI 또는 SQLNCLI11(SQL Server Native Client) 및 레거시 Microsoft OLE DB Provider for SQL Server(SQLOLEDB)는 새 애플리케이션 개발에 권장되지 않습니다.

새 프로젝트의 경우 다음 드라이버 중 하나를 사용합니다.

SQL Server 데이터베이스 엔진(버전 2012부터 2019까지)의 구성 요소로 제공되는 SQLNCLI의 경우 이 수명 주기 예외 지원을 참조하세요.

모든 데이터베이스에는 데이터베이스에 저장된 데이터가 포함된 구조가 있습니다. 권한과 같은 다른 정보와 함께 이 구조의 정의는 데이터 사전이라고도 하는 카탈로그(시스템 테이블 집합으로 구현됨)에 저장됩니다.

SQL Server Native Client ODBC 드라이버를 사용하면 애플리케이션이 ODBC 카탈로그 함수에 대한 호출을 통해 데이터베이스 구조를 확인할 수 있습니다. 카탈로그 함수는 결과 집합에 정보를 반환하고 카탈로그 저장 프로시저를 사용하여 카탈로그의 시스템 테이블을 쿼리하여 구현됩니다. 예를 들어 애플리케이션은 시스템의 모든 테이블 또는 특정 테이블의 모든 열에 대한 정보를 포함하는 결과 집합을 요청할 수 있습니다. 표준 ODBC 카탈로그 함수는 애플리케이션이 연결된 SQL Server에서 카탈로그 정보를 가져오는 데 사용됩니다.

SQL Server는 여러 다른 유형의 OLE DB 데이터 원본의 데이터에 단일 쿼리로 액세스하는 분산 쿼리를 지원합니다. 원격 OLE DB 데이터 원본에 액세스하는 방법 중 하나는 데이터 원본을 연결된 서버로 정의하는 것입니다. 이 작업은 sp_addlinkedserver 사용하여 수행할 수 있습니다. 연결된 서버를 정의한 후에는 네 부분으로 된 이름을 사용하여 Transact-SQL 문에서 해당 서버의 개체를 참조할 수 있습니다.

linked_server_name.catalog.schema.object_name입니다.

SQL Server Native Client ODBC 드라이버는 연결된 서버에서 카탈로그 정보를 가져오는 데 도움이 되는 두 가지 드라이버 관련 함수를 지원합니다.

  • SQLLinkedServers

    로컬 서버에 대해 정의되어 있는 연결된 서버 목록을 반환합니다.

  • SQLLinkedCatalogs

    연결된 서버에 포함된 카탈로그 목록을 반환합니다.

연결된 서버 이름과 카탈로그 이름이 있으면 SQL Server Native Client ODBC 드라이버는 두 부분으로 구성된 linked_server_name 이름을 사용하여 카탈로그에서 정보 가져오기를 지원합니다.다음 ODBC 카탈로그 함수의 CatalogName 카탈로그:

  • SQLColumnPrivileges

  • SQLColumns

  • SQLPrimaryKeys

  • SQLStatistics

  • SQLTablePrivileges

  • SQLTables

두 부분으로 구성된 linked_server_name.카탈로그는 SQLForeignKeys의 FKCatalogName 및 PKCatalogName에도 지원됩니다.

SQLLinkedServers 및 SQLLinkedCatalogs를 사용하려면 다음 파일이 필요합니다.

  • sqlncli.h

    연결된 서버 카탈로그 함수를 위한 함수 프로토타입 및 상수 정의를 포함합니다. sqlncli.h는 ODBC 애플리케이션에 포함되어야 하며 애플리케이션이 컴파일될 때 포함 경로에 있어야 합니다.

  • sqlncli11.lib

    링커의 라이브러리 경로에 있어야 하며 링크할 파일로 지정해야 합니다. sqlncli11.lib는 SQL Server Native Client ODBC 드라이버와 함께 배포됩니다.

  • sqlncli11.dll

    실행 시 존재해야 합니다. sqlncli11.dll SQL Server Native Client ODBC 드라이버와 함께 배포됩니다.

참고 항목

SQL Server Native Client(ODBC)
SQLColumnPrivileges
SQLColumns
SQLPrimaryKeys
SQLTablePrivileges
SQLTables
SQLStatistics