다음을 통해 공유

CDaoQueryDefInfo 구조체

  • 아티클

구조체에는 CDaoQueryDefInfo DAO(데이터 액세스 개체)에 대해 정의된 querydef 개체에 대한 정보가 포함됩니다.

구문

struct CDaoQueryDefInfo
{
    CString m_strName;               // Primary
    short m_nType;   // Primary
    COleDateTime m_dateCreated;      // Secondary
    COleDateTime m_dateLastUpdated;  // Secondary
    BOOL m_bUpdatable;               // Secondary
    BOOL m_bReturnsRecords;          // Secondary
    CString m_strSQL;                // All
    CString m_strConnect;            // All
    short m_nODBCTimeout;            // All
};

매개 변수

m_strName
querydef 개체의 이름을 고유하게 지정합니다. 자세한 내용은 DAO 도움말의 "Name 속성" 항목을 참조하세요. CDaoQueryDef::GetName을 호출하여 이 속성을 직접 검색합니다.

m_nType
querydef 개체의 작동 형식을 나타내는 값입니다. 값은 다음 중 하나입니다.

  • dbQSelect 선택 - 쿼리에서 레코드를 선택합니다.

  • dbQAction 작업 - 쿼리가 데이터를 이동하거나 변경하지만 레코드를 반환하지는 않습니다.

  • dbQCrosstab Crosstab - 쿼리는 스프레드시트와 유사한 형식으로 데이터를 반환합니다.

  • dbQDelete Delete - 쿼리가 지정된 행 집합을 삭제합니다.

  • dbQUpdate 업데이트 - 쿼리가 레코드 집합을 변경합니다.

  • dbQAppend 추가 - 쿼리는 테이블 또는 쿼리의 끝에 새 레코드를 추가합니다.

  • dbQMakeTable 테이블 만들기 - 쿼리는 레코드 집합에서 새 테이블을 만듭니다.

  • dbQDDL 데이터 정의 - 쿼리는 테이블 또는 해당 파트의 구조에 영향을 줍니다.

  • dbQSQLPassThrough 통과 - SQL 문은 중간 처리 없이 데이터베이스 백 엔드에 직접 전달됩니다.

  • dbQSetOperationUnion - 쿼리는 중복 레코드가 제거된 두 개 이상의 테이블에 있는 지정된 모든 레코드의 데이터를 포함하는 스냅샷 형식 레코드 집합 개체를 만듭니다. 중복 항목을 포함하려면 querydef의 SQL 문에 키워드(keyword) ALL을 추가합니다.

  • dbQSPTBulkdbQSQLPassThrough 레코드를 반환하지 않는 쿼리를 지정하는 데 사용됩니다.

참고 항목

SQL 통과 쿼리를 만들려면 상수는 dbQSQLPassThrough 설정하지 않습니다. 쿼리 정의 개체를 만들고 커넥트 속성을 설정할 때 Microsoft Jet 데이터베이스 엔진에서 자동으로 설정됩니다.

자세한 내용은 DAO 도움말의 "Type 속성" 항목을 참조하세요.

m_dateCreated
querydef를 만든 날짜 및 시간입니다. querydef가 만들어진 날짜를 직접 검색하려면 테이블과 연결된 개체의 CDaoTableDef GetDateCreated 멤버 함수를 호출합니다. 자세한 내용은 아래 주석을 참조하세요. DAO 도움말에서 "DateCreated, LastUpdated 속성" 항목도 참조하세요.

m_dateLastUpdated
쿼리 정의에 대한 가장 최근 변경 내용의 날짜 및 시간입니다. 테이블이 마지막으로 업데이트된 날짜를 직접 검색하려면 querydef의 GetDateLastUpdated 멤버 함수를 호출합니다. 자세한 내용은 아래 주석을 참조하세요. DAO 도움말에서 "DateCreated, LastUpdated 속성" 항목을 참조하세요.

m_bUpdatable
querydef 개체를 변경할 수 있는지 여부를 나타냅니다. 이 속성이 TRUE이면 querydef를 업데이트할 수 있습니다. 그렇지 않으면 그렇지 않습니다. 업데이트 가능은 querydef 개체의 쿼리 정의를 변경할 수 있습니다. 쿼리 정의를 업데이트할 수 있는 경우 결과 레코드 집합을 업데이트할 수 없는 경우에도 querydef 개체의 업데이트 가능 속성이 TRUE로 설정됩니다. 이 속성을 직접 검색하려면 querydef의 CanUpdate 멤버 함수를 호출합니다. 자세한 내용은 DAO 도움말의 "Updatable 속성" 항목을 참조하세요.

m_bReturnsRecords
외부 데이터베이스에 대한 SQL 통과 쿼리가 레코드를 반환하는지 여부를 나타냅니다. 이 속성이 TRUE이면 쿼리는 레코드를 반환합니다. 이 속성을 직접 검색하려면 CDaoQueryDef::GetReturnsRecords를 호출 합니다. 외부 데이터베이스에 대한 모든 SQL 통과 쿼리가 레코드를 반환하는 것은 아닙니다. 예를 들어 SQL UPDATE 문은 레코드를 반환하지 않고 레코드를 업데이트하는 반면 SQL SELECT 문은 레코드를 반환합니다. 자세한 내용은 DAO 도움말의 "ReturnsRecords 속성" 항목을 참조하세요.

m_strSQL
querydef 개체에 의해 실행되는 쿼리를 정의하는 SQL 문입니다. SQL 속성에는 쿼리를 실행할 때 레코드를 선택, 그룹화 및 정렬하는 방법을 결정하는 SQL 문이 포함되어 있습니다. 쿼리를 사용하여 다이나셋 또는 스냅샷 형식 레코드 집합 개체에 포함할 레코드를 선택할 수 있습니다. 레코드를 반환하지 않고 데이터를 수정하는 대량 쿼리를 정의할 수도 있습니다. querydef의 GetSQL 멤버 함수를 호출하여 이 속성의 값을 직접 검색할 수 있습니다.

m_str커넥트
통과 쿼리에 사용되는 데이터베이스의 원본에 대한 정보를 제공합니다. 이 정보는 연결 문자열의 형태를 사용합니다. 연결 문자열에 대한 자세한 내용과 이 속성의 값을 직접 검색하는 방법에 대한 자세한 내용은 CDaoDatabase::Get커넥트 멤버 함수를 참조하세요.

m_nODBCTimeout
ODBC 데이터베이스에서 쿼리를 실행할 때 시간 제한 오류가 발생하기 전에 Microsoft Jet 데이터베이스 엔진이 대기하는 시간(초)입니다. Microsoft SQL Server와 같은 ODBC 데이터베이스를 사용하는 경우 네트워크 트래픽 또는 ODBC 서버의 사용량이 많기 때문에 지연될 수 있습니다. 무기한 대기하는 대신 Microsoft Jet 엔진이 오류를 생성하기 전에 대기하는 시간을 지정할 수 있습니다. 기본 시간 제한 값은 60초입니다. querydef의 GetODBCTimeout 멤버 함수를 호출하여 이 속성의 값을 직접 검색할 수 있습니다. 자세한 내용은 DAO 도움말의 "ODBCTimeout 속성" 항목을 참조하세요.

설명

querydef는 CDaoQueryDef 클래스의 개체입니다. 위의 기본, 보조 및 모두에 대한 참조는 클래스CDaoDatabase의 GetQueryDefInfo 멤버 함수에서 정보를 반환하는 방법을 나타냅니다.

CDaoDatabase::GetQueryDefInfo 멤버 함수에서 검색한 정보는 구조체에 CDaoQueryDefInfo 저장됩니다. QueryDefs 컬렉션에서 querydef 개체가 저장된 데이터베이스 개체를 호출 GetQueryDefInfo 합니다. CDaoQueryDefInfo도 디버그 빌드에서 Dump 멤버 함수를 정의합니다. Dump를 사용하여 CDaoQueryDefInfo 개체의 콘텐츠를 덤프할 수 있습니다. 또한 클래스 CDaoDatabase 는 개체에서 반환된 모든 속성에 직접 액세스하기 위한 멤버 함수를 CDaoQueryDefInfo 제공하므로 호출 GetQueryDefInfo할 필요가 거의 없습니다.

querydef 개체의 Fields 또는 Parameters 컬렉션에 새 필드 또는 매개 변수 개체를 추가하면 기본 데이터베이스가 새 개체에 대해 지정된 데이터 형식을 지원하지 않는 경우 예외가 throw됩니다.

날짜 및 시간 설정은 querydef를 만들거나 마지막으로 업데이트한 컴퓨터에서 파생됩니다. 다중 사용자 환경에서 사용자는 DateCreated 및 LastUpdated 속성 설정의 불일치를 방지하기 위해 순 시간 명령을 사용하여 파일 서버에서 직접 이러한 설정을 가져와야 합니다.

요구 사항

헤더: afxdao.h

참고 항목

구조체, 스타일, 콜백 및 메시지 맵
CDaoQueryDef 클래스
CDaoDatabase 클래스