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

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

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

    시작하기 전에

    코어 UI 플러그인(com.glide.ui.ui16)을 활성화해야 합니다.

    필요한 역할: cmdb_query_builder_read 저장된 쿼리를 보고 실행하기만 하고 cmdb_query_builder(itil, itil_admin 및 asset에 포함됨)하여 쿼리를 만들고 저장하며, 저장된 쿼리를 수정하고, 쿼리를 실행합니다.

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

    이 태스크 정보

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

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

    쿼리 작성기 사용에 대한 자세한 내용은 CMDB 쿼리 작성기 쿼리 및 보고 - Platform Analytics Academy 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를 통해 직접 또는 간접적으로 연결된 경우 최대 2번째 수준 관계 입니다.
        3. 관계 유형 및 관련 항목 섹션에서 다음 옵션 중 하나를 선택합니다.
          옵션 설명
          관계 없음 Windows Server에 연결되지 않은 모든 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. 저장을 클릭합니다.

      Saved Queries(저장된 쿼리) 탭에서 저장된 쿼리 위젯을 가리키고 Query Information(쿼리 정보)을 클릭합니다. 쿼리 유형, 마지막 업데이트 날짜, 쿼리와 연결된 CMDB 그룹, 쿼리 일정 등의 쿼리 상세 정보가 나타납니다.

    다음에 수행할 작업

    • 실행을 클릭합니다.

      쿼리의 처음 100개 결과만 결과 창에 나타납니다.
      • 더 많은 결과 로드를 클릭하여 다음 100개 결과 세트를 봅니다.
      • 모든 결과 로드를 클릭하여 glide.cmdb.query.max_results_limit 시스템 속성에 지정된 숫자(기본적으로 10,000개)까지 나머지 쿼리 결과를 봅니다.

      CI를 클릭하여 해당 CI 양식을 열고, CI 양식에서 대시보드 를 클릭하여 CI 대시보드에서 CI 상태를 봅니다.

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

      Query Results(쿼리 결과) 컨텍스트 메뉴를 클릭하고 Export(내보내기)를 선택합니다. 추가 쿼리 결과가 있음을 나타내는 더 많은 결과 로드 단추가 표시되더라도 표시되는 결과만 내보내집니다.

    • CMDB 쿼리 익스포트 및 임포트 인스턴스 간에 쿼리 정의를 이식합니다.
    • 저장된 쿼리를 사용하여 CMDB 그룹을 채웁니다.
    • CMDB 쿼리 삭제.