sp_fkeys(Transact-SQL)

아티클
08/11/2023

적용 대상: Microsoft Fabric의 SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics AnalyticsPlatform System(PDW) Warehouse

현재 환경에 대한 논리적 외래 키 정보를 반환합니다. 이 절차에서는 사용하지 않도록 설정된 외래 키를 비롯한 외래 키 관계를 보여줍니다.

Transact-SQL 구문 표기 규칙

구문

sp_fkeys [ @pktable_name = ] 'pktable_name'   
     [ , [ @pktable_owner = ] 'pktable_owner' ]   
     [ , [ @pktable_qualifier = ] 'pktable_qualifier' ]   
     { , [ @fktable_name = ] 'fktable_name' }   
     [ , [ @fktable_owner = ] 'fktable_owner' ]   
     [ , [ @fktable_qualifier = ] 'fktable_qualifier' ]

인수

[ @pktable_name=] 'pktable_name'
카탈로그 정보를 반환하는 데 사용되는 기본 키가 있는 테이블의 이름입니다. pktable_name sysname이며 기본값은 NULL입니다. 와일드카드 패턴 일치는 지원되지 않습니다. 이 매개 변수 또는 fktable_name 매개 변수 또는 둘 다를 제공해야 합니다.

[ @pktable_owner=] 'pktable_owner'
카탈로그 정보를 반환하는 데 사용되는 테이블 소유자(기본 키 포함)의 이름입니다. pktable_owner sysname이며 기본값은 NULL입니다. 와일드카드 패턴 일치는 지원되지 않습니다. pktable_owner 지정하지 않으면 기본 DBMS의 기본 테이블 표시 유형 규칙이 적용됩니다.

SQL Server에서 현재 사용자가 지정된 이름의 테이블을 소유하는 경우 해당 테이블의 열이 반환됩니다. pktable_owner 지정되지 않고 현재 사용자가 지정된 pktable_name 있는 테이블을 소유하지 않는 경우 프로시저는 데이터베이스 소유자가 소유한 지정된 pktable_name 있는 테이블을 찾습니다. 테이블 열이 있으면 해당 테이블의 열이 반환됩니다.

[ @pktable_qualifier =] 'pktable_qualifier'
테이블의 이름(기본 키 포함) 한정자입니다. pktable_qualifier sysname이며 기본값은 NULL입니다. 다양한 DBMS 제품은 테이블(qualifier.owner.name)에 대해 세 부분으로 구성된 명명을 지원합니다. SQL Server에서 한정자는 데이터베이스 이름을 나타냅니다. 일부 제품에서는 테이블 데이터베이스 환경의 서버 이름을 나타냅니다.

[ @fktable_name=] 'fktable_name'
카탈로그 정보를 반환하는 데 사용되는 외래 키가 있는 테이블 이름입니다. fktable_name sysname이며 기본값은 NULL입니다. 와일드카드 패턴 일치는 지원되지 않습니다. 이 매개 변수 또는 pktable_name 매개 변수 또는 둘 다를 제공해야 합니다.

[ @fktable_owner =] 'fktable_owner'
카탈로그 정보를 반환하는 데 사용되는 테이블 소유자(외래 키 포함)의 이름입니다. fktable_owner sysname이며 기본값은 NULL입니다. 와일드카드 패턴 일치는 지원되지 않습니다. fktable_owner 지정하지 않으면 기본 DBMS의 기본 테이블 표시 유형 규칙이 적용됩니다.

SQL Server에서 현재 사용자가 지정된 이름의 테이블을 소유하는 경우 해당 테이블의 열이 반환됩니다. fktable_owner 지정되지 않고 현재 사용자가 지정된 fktable_name 있는 테이블을 소유하지 않는 경우 프로시저는 데이터베이스 소유자가 소유한 지정된 fktable_name 있는 테이블을 찾습니다. 테이블 열이 있으면 해당 테이블의 열이 반환됩니다.

[ @fktable_qualifier= ] 'fktable_qualifier'
외래 키가 있는 테이블 한정자의 이름입니다. fktable_qualifier sysname이며 기본값은 NULL입니다. SQL Server에서 한정자는 데이터베이스 이름을 나타냅니다. 일부 제품에서는 테이블 데이터베이스 환경의 서버 이름을 나타냅니다.

반환 코드 값

아니요

결과 집합

열 이름	데이터 형식	설명
PKTABLE_QUALIFIER	sysname	테이블의 이름(기본 키 포함) 한정자입니다. 이 필드는 NULL이 될 수 있습니다.
PKTABLE_OWNER	sysname	기본 키가 있는 테이블의 소유자 이름입니다. 이 필드는 항상 값을 반환합니다.
PKTABLE_NAME	sysname	기본 키가 있는 테이블의 이름입니다. 이 필드는 항상 값을 반환합니다.
PKCOLUMN_NAME	sysname	반환된 TABLE_NAME 각 열에 대한 기본 키 열의 이름입니다. 이 필드는 항상 값을 반환합니다.
FKTABLE_QUALIFIER	sysname	외래 키가 있는 테이블의 한정자 이름입니다. 이 필드는 NULL이 될 수 있습니다.
FKTABLE_OWNER	sysname	외래 키가 있는 테이블 소유자의 이름입니다. 이 필드는 항상 값을 반환합니다.
FKTABLE_NAME	sysname	외래 키가 있는 테이블의 이름입니다. 이 필드는 항상 값을 반환합니다.
FKCOLUMN_NAME	sysname	반환된 TABLE_NAME 각 열에 대한 외래 키 열의 이름입니다. 이 필드는 항상 값을 반환합니다.
KEY_SEQ	smallint	여러 열 기본 키에 있는 열의 시퀀스 번호입니다. 이 필드는 항상 값을 반환합니다.
UPDATE_RULE	smallint	SQL 작업이 업데이트일 때 외래 키에 적용되는 동작입니다. 가능한 값: 0=CASCADE는 외래 키를 변경합니다. 1=NO ACTION은 외래 키가 있으면 변경합니다. 2 = null 설정 3 = 기본값 설정
DELETE_RULE	smallint	SQL 작업이 삭제되면 외래 키에 적용된 작업입니다. 가능한 값: 0=CASCADE는 외래 키를 변경합니다. 1=NO ACTION은 외래 키가 있으면 변경합니다. 2 = null 설정 3 = 기본값 설정
FK_NAME	sysname	외래 키 식별자입니다. 데이터 원본에 적용되지 않는 경우 NULL입니다. SQL Server는 FOREIGN KEY 제약 조건 이름을 반환합니다.
PK_NAME	sysname	기본 키 식별자입니다. 데이터 원본에 적용되지 않는 경우 NULL입니다. SQL Server는 PRIMARY KEY 제약 조건 이름을 반환합니다.

반환되는 결과는 FKTABLE_QUALIFIER, FKTABLE_OWNER, FKTABLE_NAME 및 KEY_SEQ 따라 정렬됩니다.

설명

외래 키를 사용할 수 없는 테이블을 포함하는 애플리케이션 코딩은 다음과 같은 방법으로 구현됩니다.

테이블에 관한 작업을 하는 동안 제약 조건 확인(ALTER TABLE NOCHECK 또는 CREATE TABLE NOT FOR REPLICATION)을 일시적으로 사용하지 못하게 한 다음 나중에 다시 사용할 수 있도록 합니다.
트리거 또는 애플리케이션 코드를 사용하여 관계를 적용합니다.

기본 키 테이블 이름은 제공되고 외래 키 테이블 이름이 NULL인 경우 sp_fkeys는 외래 키를 포함한 모든 테이블을 지정된 테이블로 반환합니다. 외래 키 테이블 이름이 제공되고 기본 키 테이블 이름이 NULL인 경우 sp_fkeys 외래 키 테이블의 외래 키에 대한 기본 키/외래 키 관계와 관련된 모든 테이블을 반환합니다.

sp_fkeys 저장 프로시저는 ODBC의 SQLForeignKeys와 동일합니다.

사용 권한

스키마에 SELECT 대한 권한이 필요합니다.

예

다음 예제에서는 데이터베이스의 테이블에 AdventureWorks2022 대한 HumanResources.Department 외세 키 목록을 검색합니다.

USE AdventureWorks2022;  
GO  
EXEC sp_fkeys @pktable_name = N'Department'  
    ,@pktable_owner = N'HumanResources';

예: Azure Synapse Analytics 및 분석 플랫폼 시스템(PDW)

다음 예제에서는 데이터베이스의 테이블에 AdventureWorksPDW2012 대한 DimDate 외세 키 목록을 검색합니다. Azure Synapse Analytics는 외세 키를 지원하지 않으므로 행이 반환되지 않습니다.

EXEC sp_fkeys @pktable_name = N'DimDate';

참고 항목

카탈로그 저장 프로시저(Transact-SQL)
시스템 저장 프로시저(Transact-SQL)
sp_pkeys(Transact-SQL)