CMDB 쿼리 작성기를 사용하여 CMDB 쿼리 빌드

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기7분

    • 인프라에서 CI 클래스 및 선택적으로 비 CMDB 테이블, 그리고 이들을 연결하는 관계와 참조를 쿼리하는 CMDB 쿼리 유형입니다.

    시작하기 전에

    필요한 역할: cmdb_query_builder_read 저장된 쿼리만 보고 실행하고, cmdb_query_builder(itil, itil_admin 및 asset에 포함)하여 쿼리를 생성 및 저장하고, 저장된 쿼리를 수정하고, 쿼리를 실행합니다. 쿼리를 보고하려면 보고서 관련 ACL이 필요합니다.

    권한 있는 사용자는 다른 사용자가 만든 쿼리를 업데이트하고 삭제할 수 있습니다.

    이 태스크 정보

    쿼리에 포함할 CI 클래스와 비 CMDB 테이블을 끌어서 쿼리를 빌드합니다. 그런 다음 캔버스에 노드로 놓고 둘 사이의 관계 속성을 정의합니다. 노드의 속성을 필터링하여 해당 클래스의 특정 CI 세트 또는 특정 단일 CI로 결과 범위를 좁힐 수 있습니다. 쿼리 결과에 표시할 속성 열을 선택할 수도 있습니다.

    쿼리 작성을 단계별로 진행하면 선택 항목에 따라 CMDB 쿼리 작성기의 목록 옵션 및 기타 사용자 인터페이스 요소가 동적으로 필터링됩니다.

    쿼리 작성기 사용에 대한 자세한 내용은 CMDB 쿼리 작성기 쿼리 및 보고 - 플랫폼 분석 아카데미 ServiceNow 커뮤니티 비디오를 참조하십시오. 애플리케이션 서비스를 통한 쿼리를 포함하여 쿼리 빌더에서 CMDB 쿼리를 작성하는 단계별 연습은 을 참조하십시오 예제 쿼리.

    프로시저

    1. 다음으로 이동 모두 > 구성 을 클릭하고 CMDB 쿼리 작성기를 선택합니다.
    2. CMDB 쿼리 작성기 페이지에서 다음 단계 중 하나를 수행합니다.
      • 새로 생성을 선택합니다. Name(이름)을 입력하고 Query type(쿼리 유형)으로 CMDB Query(CMDB 쿼리)를 선택한 다음 Create(생성)를 선택합니다.
      • 저장된 쿼리의 위젯을 선택하여 기존 쿼리를 계속 작성합니다. 저장된 쿼리 검색 필요한 경우 먼저.
      • 저장된 쿼리 위젯의 오른쪽 위 모서리를 가리키고 쿼리 복제 아이콘을 선택하여 저장된 쿼리의 사본을 편집합니다. 새 쿼리의 기본 이름에는 문자열 'copy'가 포함됩니다.
    3. 캔버스에서 다음 작업을 수행할 수 있습니다.
      • 쿼리에 CI 클래스 추가: CMDB 클래스 탭의 계층 구조 목록에서 클래스를 선택하고 캔버스로 끌어옵니다.

      • 쿼리에 애플리케이션 서비스 CI를 추가합니다. CMDB 클래스 탭의 계층 구조 목록에서 애플리케이션 서비스 클래스를 선택하고 캔버스로 끌어옵니다.

        오른쪽 표시줄의 애플리케이션 서비스 속성에서 연결된 노드를 패턴으로 변환 을 선택하여 애플리케이션 서비스와 다른 CMDB 클래스 노드 사이의 패턴을 쿼리할 수 있습니다. 패턴에 대해 쿼리할 때 패턴 연결의 양쪽 끝에 있는 노드는 여러 수준 떨어져 있을 수 있습니다. 연결된 노드를 패턴으로 변환을 선택하지 않으면 애플리케이션 서비스 노드와 다른 CMDB 클래스 노드 간의 연결이 직접 관계를 나타냅니다.

      • 쿼리에 비 CMDB 테이블 추가: 비 CMDB 테이블 목록에서 테이블을 선택하고 캔버스로 끌어 옵니다.
        주:
        비 CMDB 테이블은 쿼리의 시작 노드가 될 수 없습니다.
      • 캔버스의 두 노드 간 연결(애플리케이션 서비스에 대한 관계 또는 패턴)을 추가합니다.
        1. 연결의 첫 번째 노드에서 오른쪽 중앙에 있는 작은 사각형을 선택합니다.
        2. 연결의 두 번째 노드에서 왼쪽 중앙에 있는 작은 사각형을 선택하여 연결을 작성합니다.
        표 1. 연결 UI 표기법
        표기법 설명
        전체 라인 CMDB 쿼리의 관계입니다.
        연결선 중앙의 빨간색 별표 관계 유형과 같은 정보가 누락되어 쿼리가 무효화됩니다.
        레벨:<n> 유형:<n> 또는 연결선의 <참조 유형> 표기법

        해당하는 경우: 연결에 포함된 관계 수준 수와 관계 유형 수입니다. 또는 참조인 관계에 대한 참조 유형입니다.
        파선 애플리케이션 서비스 노드와 다른 노드 간의 패턴 연결입니다.
      • 오른쪽 표시줄의 연결 속성에서 관계 설정을 구성합니다(필요한 경우 연결선 선택).
        1. 관계 방향 섹션에서 상위 노드를 선택합니다( 하위 노드가 자동으로 조정됨).
        2. CI가 직접 연결되어 있는 경우 관계 수준 섹션에서 수준을첫 번째 수준 관계 로 설정합니다. 또는 CI가 다른 CI를 통해 직접 또는 간접적으로 연결된 경우 최대 두 번째 수준 관계 입니다.
        3. 관계 유형 및 관련 항목 섹션에서 다음 옵션 중 하나를 선택합니다.
          옵션 설명
          관계 없음 Windows 서버에 연결되지 않은 모든 Tomcat WAR CI와 같이 연결 관계가 없는 CI를 쿼리합니다.
          관계 유형 추가 특정 관계 유형 또는 관계 유형을 선택합니다.
          관련 항목 추가 노드 간 관련 CI를 쿼리하기 위해
      • 비 CMDB 테이블에 대한 연결에 대한 CI 참조 열을 구성합니다. 연결 속성 오른쪽 표시줄의 CI 참조 열 섹션에 있는 CI 참조 열 사용 목록에서 CI 참조가 있는 열을 선택합니다. 하나의 옵션만 사용할 수 있는 경우 자동으로 선택됩니다.
      • 연결된 노드를 패턴으로 변환 옵션으로 설정된 애플리케이션 서비스 노드와 비 CMDB 테이블 노드 간에 패턴을 구성합니다. 패턴의 모든 노드에 참조 필터적용 <table> 을 선택하여 애플리케이션 서비스 CI 자체와 애플리케이션 서비스 내 CI에 쿼리를 적용합니다.
      • 클래스 노드에 필터 추가: 필터를 적용하여 클래스 쿼리를 특정 CI 세트 또는 특정 CI 하나로 좁힙니다.
        1. 필터를 추가할 노드를 가리킨 다음, 노드 위에 팝업되는 필터 적용 아이콘을 선택합니다.
        2. 필터 섹션에서 속성 및 관련 목록 조건을 추가합니다.
        3. 필터 섹션을 닫습니다.
        예를 들어 데이터베이스 위치에 대한 필터를 추가하여 시애틀에 있는 데이터베이스를 쿼리합니다.

        오른쪽 막대에서 적용된 필터를 선택하여 캔버스의 각 노드에 대한 모든 필터를 봅니다.

      • 쿼리에 And/Or 연산자를 추가합니다.
        1. 한 노드를 다른 두 노드에 연결합니다.
        2. 연결선에 나타나는 And 상자를 선택하여 And/Or 연산자 간에 전환합니다.
        예: C1은 Tomcat WAR이고, C2는 Linux Server이고, C3은 Windows Server입니다. Linux 서버 또는 Windows 서버에 연결된 모든 Tomcat WAR CI를 쿼리합니다.
      • 쿼리 결과에 표시할 노드에 대한 속성 열을 추가합니다.
        주:
        관계의 경우 쿼리 결과에는 , child및 type 열이 포함됩니다parent. [cmdb_rel_ci] 테이블의 다른 열은 추가할 수 없습니다.
        1. 오른쪽 창에서 속성을 선택합니다.
        2. 노드를 한 번 또는 두 번 선택하여 보고서 열 섹션이 오른쪽 표시줄에 나타나도록 한 다음, 열 추가를 선택합니다.
        3. 속성을 선택한 다음 속성 목록 외부를 선택하여 닫습니다.
      • 쿼리를 CMDB 쿼리에 통합 서비스 매핑 하여 조합 쿼리를 생성합니다.
        1. CMDB 쿼리를 빌드할 때 왼쪽 표시줄에서 저장된 서비스 쿼리를 선택합니다.
        2. 쿼리를 선택한 후 캔버스로 끌어 서비스 매핑 옵니다.
        이 쿼리는 CMDB 쿼리를 만족하고 포함된 서비스 매핑 쿼리가 반환하는 서비스에 포함된 모든 CI를 반환합니다.
      • 저장된 쿼리에 대한 검색 기준으로 사용할 수 있는 검색 태그를 추가합니다.
        1. 캔버스 맨 위에 있는 태그 추가 아이콘을 선택합니다.
        2. Add Tag(태그 추가)를 선택하고 Query Tags(태그 쿼리) 대화 상자에 하나 이상의 태그 문자열을 입력합니다.
        3. 태그 추가(Add Tags) 아이콘을 다시 선택하여 쿼리 태그(Query Tags) 대화 상자를 닫습니다.
    4. 저장을 선택합니다.

      저장된 쿼리 탭에서 저장된 쿼리 위젯을 가리키고 쿼리 정보를 선택합니다. 쿼리 유형, 마지막 업데이트 날짜, 쿼리와 연결된 CMDB 그룹 및 쿼리 일정과 같은 쿼리 상세 정보가 나타납니다.

    다음에 수행할 작업

    • 실행을 선택합니다.

      쿼리의 처음 100개 결과만 결과 창에 나타납니다.
      • 다음 100개 결과 집합을 보려면 추가 결과 로드 를 선택합니다.
      • 모든 결과 로드를 선택하여 glide.cmdb.query.max_results_limit 시스템 속성에 지정된 수(기본적으로 10,000개)까지 나머지 쿼리 결과를 봅니다.

      CI를 선택하여 CI 양식을 열고, CI 양식에서 CMDB 작업 공간에서 열기 를 선택하여 CMDB 작업 공간의 CI 상태 타일에서 CI 상태를 확인합니다. 이 작업에는 sn_cmdb_user(CMDB 사용자) 역할이 필요합니다.

      주:
      • 모든 결과가 나타날 수 있도록 glide.security.use_csrf_token 속성이 true로 설정되어 있는지 확인합니다.
      • 수준을최대 수준 2 관계로 설정하면 관계 유형이 쿼리 결과에 나타나지 않습니다.
      • 쿼리가 실행 중일 때 다른 쿼리를 열거나 실행하기 전에 완료되거나 시간이 초과될 때까지 기다립니다.
    • 쿼리 작성기 설정 수정: 설정 아이콘을 선택합니다. (설정) 아이콘을 클릭하여 쿼리 작성기 설정 대화 상자를 엽니다.
    • 저장된 쿼리의 URL을 복사하여 CMDB 쿼리 작성기에 대한 액세스 권한이 있는 사용자와 공유합니다. 새 인터넷 브라우저 창에 공유 URL을 붙여 넣으면 CMDB 쿼리 작성기에서 저장된 쿼리가 직접 열립니다.
    • CMDB 쿼리 작성기에서 보고서 생성.
    • 나중에 쿼리를 실행하고 결과를 이해 관계자에게 이메일로 보내는 일정을 만듭니다.
    • 쿼리 결과 익스포트:

      쿼리 결과 상황에 맞는 메뉴를 선택하고 내보내기를 선택합니다. 추가 결과 로드 단추가 표시되어 추가 쿼리 결과가 있음을 나타내더라도 표시되는 결과만 내보내집니다.

    • CMDB 쿼리 익스포트 및 임포트 인스턴스 간에 쿼리 정의를 이식하기 위함입니다.
    • 저장된 쿼리를 사용하여 CMDB 그룹을 채우십시오.
    • CMDB 쿼리 삭제.