6. 검색¶

|at|에는 여러 기능에 걸쳐 검색 및 필터 기능을 모두 제공하는 강력한 검색 툴이 있습니다. 허용되는 검색 기준은 검색 필드의 이름 드롭다운 메뉴에서 고급 옵션을 통해 액세스할 수 있는 확장 가능한 《치트 시트》에 제공됩니다. 여기에서 설정 유형, 키, **조회 유형**의 조합을 사용하여 필터링합니다.

6.1. 팁 검색¶

이러한 검색 팁에서는 호스트를 검색하지 않는 것으로 가정합니다. 이 섹션의 대부분은 여전히 호스트에 적용되지만 약간의 미묘한 차이가 있습니다. 일반적인 검색 구문은 필드(왼쪽)와 값(오른쪽)으로 구성됩니다. 콜론은 값에서 검색할 필드를 구분하는 데 사용됩니다. 검색에 콜론이 없는 경우(예제 3 참조) ``?search=foobar``가 전송되는 간단한 문자열 검색으로 처리됩니다. 다음은 검색에 사용되는 구문의 예입니다.

name:localhost 이 예제에서 콜론 앞의 문자열은 검색할 필드를 나타냅니다. 해당 문자열이 필드 또는 **관련 필드**의 항목과 일치하지 않으면 예제 3과 동일한 방식으로 처리됩니다(문자열 검색). 콜론 뒤의 문자열은 이름 특성 내에서 검색할 문자열입니다.
organization.name:Default 이 예제에서는 관련 필드 검색을 보여줍니다. 이 경우 왼쪽 부분의 마침표는 필드와 모델을 구분합니다. 검색의 깊이/복잡도에 따라 왼쪽 부분에 여러 개의 마침표가 있을 수 있습니다.
foobar 이름 및 설명 필드에 대해 icontains 검색을 사용하여 해당 용어의 모든 인스턴스를 찾는 단순 문자열(주요 용어) 검색입니다. 용어(예: foo bar) 사이에 공백을 사용하면 두 용어를 모두 포함하는 결과가 반환됩니다. 용어를 따옴표로 묶는 경우(예: 《foo bar》) 컨트롤러는 용어가 함께 나타나는 전체 문자열을 검색합니다. 특정 이름 검색에서는 API 이름에 대해 검색합니다. 예를 들어 사용자 인터페이스의 ``Management job``은 API의 ``system_job``입니다.
organization:Default 이 예제에서는 관련 필드 검색을 표시하지만 조직과 함께 사용할 필드를 지정하지 않습니다. 이 검색은 API에서 지원하며 간단한 문자열 검색과 유사하지만 조직에 대해 수행됩니다(이름과 설명 모두에 대해 icontains 검색 수행).

6.1.1. 검색 필드의 값¶

특정 필드의 값을 찾으려면 API 끝점에서 광범위한 옵션과 유효한 해당 값을 참조하십시오. 예를 들어 /api/v2/jobs -> type 필드에 대해 검색하려면 /api/v2/jobs``에 대한 **옵션** 요청을 수행하여 값을 찾고 API에서 ``"type"``에 대한 항목을 찾으면 됩니다. 또한 각 화면의 맨 아래로 스크롤하여 관련 검색을 볼 수 있습니다. ``/api/v2/jobs 예제의 관련 검색에서는 다음을 표시합니다.

"related_search_fields": [
   "modified_by__search",
   "project__search",
   "project_update__search",
   "credentials__search",
   "unified_job_template__search",
   "created_by__search",
   "inventory__search",
   "labels__search",
   "schedule__search",
   "webhook_credential__search",
   "job_template__search",
   "job_events__search",
   "dependent_jobs__search",
   "launch_config__search",
   "unifiedjob_ptr__search",
   "notifications__search",
   "unified_job_node__search",
   "instance_group__search",
   "hosts__search",
   "job_host_summaries__search"

필드의 값은 가져오기 요청의 키에서 가져옵니다. url, related, ``summary_fields``는 사용되지 않습니다. 관련 필드의 값도 옵션 응답에서 제공되지만 다른 특성에서 제공됩니다. 관련 필드는 ``related_search_fields``에서 모든 값을 가져온 후 끝에서 ``__search``를 제거하여 채웁니다.

필드의 값 또는 관련 필드의 값으로 시작하지 않는 검색은 일반 문자열 검색으로 처리됩니다. localhost``와 같은 항목을 검색하면 UI에서 API 끝점에 쿼리 매개변수로 ``?search=localhost``를 보냅니다. 이는 이름 및 설명 필드에 대한 ``icontains 검색 바로 가기입니다.

6.1.3. 기타 검색 고려 사항¶

다음은 컨트롤러에서 검색할 때 알아야 할 몇 가지 사항입니다.

현재 OR 쿼리에 지원되는 구문이 없습니다. 모든 검색어에는 쿼리 매개변수에서 **AND**가 적용됩니다.
검색 매개변수의 왼쪽 부분은 공백이 있는 문자열 검색을 지원하기 위해 따옴표로 묶을 수 있습니다.
현재 필드의 값은 GET 요청에서 반환될 것으로 예상되는 직접적인 특성입니다. 컨트롤러는 값 중 하나에 대해 검색할 때마다 기본적으로 __icontains 검색을 수행합니다. 따라서 예를 들면 ``name:localhost``는 ``?name__icontains=localhost``를 다시 보냅니다. 컨트롤러는 현재 ``id``를 포함한 모든 필드 값에 대해 이 검색을 수행하는데, 이는 적절하지 않습니다.

6.2. 정렬¶

해당되는 경우 각 열의 화살표를 사용하여 오름차순 또는 내림차순으로 정렬할 수 있습니다. 다음은 스케줄 목록의 예입니다.

화살표 방향은 열의 정렬 순서를 나타냅니다.