Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# CodeCatalyst에서 코드, 문제, 프로젝트 및 사용자 검색
<a name="search"></a>

CodeCatalyst의 검색 표시줄 또는 전용 검색 결과 창을 사용하여 CodeCatalyst 내 코드, 문제, 프로젝트 및 사용자를 검색합니다.

검색 창에 이름, 설명 및 상태와 같은 쿼리를 입력하여 스페이스 및 프로젝트 전체에서 리소스를 찾을 수 있습니다. 검색 쿼리 언어를 사용하여 검색 쿼리를 구체화할 수도 있습니다.

**Topics**
+ [검색 쿼리 구체화](#search-query-language-examples)
+ [검색 작업 시 고려 사항](#search-tips-troubleshooting)
+ [검색 가능한 필드 참조](#search-query-language-searchable-fields)

**검색하려면**

1. 상단 탐색 모음의 검색 창에 검색 쿼리를 입력합니다.

1. (선택 사항) CodeCatalyst 검색 쿼리 언어를 사용하여 검색 쿼리를 구체화합니다. 자세한 내용은 [검색 쿼리 구체화](#search-query-language-examples) 섹션을 참조하세요.

1. 다음 중 하나를 수행합니다.
   + 현재 진행 중인 프로젝트 내에서 리소스를 검색하려면 **이 프로젝트**를 선택합니다.
   + 현재 있는 스페이스의 모든 프로젝트 내에서 리소스를 검색하려면 **이 스페이스**를 선택합니다.

1. 다음 중 하나를 수행하여 전용 검색 결과 창에서 검색 결과를 봅니다.
   + 빠른 검색 결과 창 하단에서 **project-name \| space-name의 모든 결과 보기**를 선택하여 모든 검색 결과를 봅니다.
   + **Enter**를 눌러 모든 검색 결과를 봅니다.

**작은 정보**  
표시 이름 또는 사용자 이름 앞에 @ 기호를 사용하여 풀 요청 주석 또는 설명 또는 문제 주석 또는 설명에서 다른 프로젝트 사용자를 언급합니다. 문제 또는 코드 파일 이름 앞에 @ 기호를 사용하여 문제 또는 코드 파일과 같은 리소스에 연결할 수도 있습니다.

## 검색 쿼리 구체화
<a name="search-query-language-examples"></a>

검색 후 원하는 내용을 찾을 수 없는 경우 CodeCatalyst 특수 쿼리 언어를 사용하여 검색을 세분화할 수 있습니다. 개별 필드에는 문자 제한이 없지만, 전체 쿼리에서는 1,024자로 제한됩니다.

**Topics**
+ [유형별 구체화](#search-query-language-type-search)
+ [필드별 구체화](#search-query-language-field-search)
+ [부울 연산자를 사용한 구체화](#search-query-language-boolean-search)
+ [프로젝트별 구체화](#search-query-language-project-search)

### 유형별 구체화
<a name="search-query-language-type-search"></a>

검색 범위를 특정 유형의 정보로 구체화하려면 검색에 `{{type:result-type}}`를 포함하세요. 여기서 {{결과 유형}}은 `code`, `issue`, `project`또는 `user` 입니다.

예시:
+ `type:code AND java` - “java”가 포함된 코드 관련 필드에 코드 결과를 표시합니다.

  자세한 내용은 [코드 필드](#search-query-language-type-code) 섹션을 참조하세요.
+ `type:issue AND Bug` - “버그”가 포함된 문제 관련 필드에 문제 결과를 표시합니다.

  자세한 내용은 [문제 필드](#search-query-language-type-issue) 섹션을 참조하세요.
+ `type:user AND MaryMajor` - “MaryMajor”가 포함된 사용자 관련 필드에 사용자 결과를 표시합니다.

  자세한 내용은 [사용자 필드](#search-query-language-type-user) 섹션을 참조하세요.
+ `type:project AND Datafeeder` - “Datafeeder”가 포함된 프로젝트 결과를 표시합니다.

  자세한 내용은 [프로젝트 필드](#search-query-language-type-project) 섹션을 참조하세요.

### 필드별 구체화
<a name="search-query-language-field-search"></a>

검색 범위를 특정 필드로 구체화하려면 검색에 `{{field-name:query}}`를 포함하세요. 여기서 {{필드 이름은}} `title`, `username`, `project``description`, 등이고 {{쿼리}}는 검색하려는 텍스트입니다. 필드 목록은 [검색 가능한 필드 참조](#search-query-language-searchable-fields) 섹션을 참조하세요. 괄호를 사용하여 여러 쿼리를 검색할 수 있습니다.

예시:
+ `title:bug` - 제목에 “버그”가 포함된 결과를 표시합니다.
+ `username:John` - 사용자 이름에 “John”이 포함된 결과를 표시합니다.
+ `project:DataFeeder` - “DataFeeder” 프로젝트의 결과를 표시합니다. 쿼리는 대/소문자를 구분하지 않습니다.
+ `description:overview` – 설명에 “개요”가 포함된 결과를 표시합니다.

### 부울 연산자를 사용한 구체화
<a name="search-query-language-boolean-search"></a>

검색 구문에 제약 조건을 지정하려면 부울 연산자 `AND`, `OR` 및 `NOT`을 사용할 수 있습니다. 여러 구문을 나열하는 경우, CodeCatalyst는 기본적으로 해당 구문을 `OR`과 조인합니다. 괄호를 사용하여 검색 구문을 그룹화할 수 있습니다.
+ `exception AND type:code` - “예외”에 대한 코드 결과만 표시합니다.
+ `path:README.md AND repo:ServerlessAPI` - 리포지토리 이름이 “ServerlessAPI ”인 “README.md”를 사용하여 경로에 대한 결과를 표시합니다.
+ `buildspec.yml AND (repo:ServerlessAPI OR ServerlessWebApp)` - 리포지토리가 “ServerlessAPI ” 또는 “ServerlessWebApp”인 “buildspec.yml”에 대한 결과를 표시합니다.
+ `path:java NOT (path:py OR path:ts)` - 경로에 “java”가 포함되어 있지만 “py” 또는 “ts”가 포함되어 있지 않은 결과를 표시합니다.

### 프로젝트별 구체화
<a name="search-query-language-project-search"></a>

검색 범위를 특정 프로젝트로 구체화하려면 검색에 `{{project:name AND query}}`를 포함합니다. 여기서 {{이름은}} 검색하려는 프로젝트이고 {{쿼리}}는 검색하려는 콘텐츠입니다.
+ `project:name AND query` - 경로에 쿼리와 프로젝트 이름이 포함된 결과를 표시합니다.

## 검색 작업 시 고려 사항
<a name="search-tips-troubleshooting"></a>

**지연된 콘텐츠 업데이트** - 이름 변경 또는 문제 재할당과 같은 콘텐츠 업데이트가 검색 결과에 반영되는 데 몇 분 정도 걸릴 수 있습니다. 코드 기반 마이그레이션과 같은 대규모 업데이트가 검색 결과에 나타나는 데 더 오래 걸릴 수 있습니다.

**특수 문자 이스케이프 처리** - 검색 쿼리에서 `+ - & & || ! ( ) { } [ ] ^ " ~ * ? : \`와 같은 특수 문자를 특별히 고려해야 합니다. 특수 문자는 쿼리에 영향을 주지 않으므로 특수 문자를 제거하거나 이스케이프 처리해야 합니다. 문자를 이스케이프 처리하려면 앞에 백슬래시(\\)를 추가합니다. 예를 들어, 검색 쿼리 [Feature]는 Feature 또는 \\[Feature\\]여야 합니다.

**검색 범위 좁히기** - 검색은 대/소문자를 구분하지 않습니다. 소문자로만 검색하면 쿼리에서 대소문자 변경에 따른 단어 분할이 일어나지 않습니다. 예를 들어 `MyService`를 쿼리하거나 `MyService`만 쿼리하려면, `my` 또는 `service`만 포함된 결과를 피하기 위해 `myservice`를 쿼리하는 방법을 고려하세요.

검색은 기본적으로 OR을 기준으로 단어와 단어의 일부를 조인합니다. 예를 들어, `new function`는 `new` 및 `function`을 모두 포함하는 결과를 반환할 수 있으며, 결과는 `new` 또는 `function`로만 반환할 수 있습니다. 후자를 방지하려면 여러 단어를 `AND`와 결합합니다. 예를 들어, `new AND function`을 검색합니다.

**기본 브랜치** - 검색은 소스 리포지토리의 기본 브랜치에 대한 최신 커밋의 코드 결과만 반환합니다. 다른 브랜치 또는 커밋에서 코드를 찾으려면 [리포지토리를 로컬로 복제](source-repositories-clone.md)하거나, [개발 환경에서 브랜치를 열거나](devenvironment-create.md), [CodeCatalyst UI에서 브랜치 및 세부 정보를 보는](source-branches-view.md) 방법을 고려합니다. 기본 브랜치를 변경하면 검색으로 확인할 수 있는 파일이 업데이트됩니다. 자세한 내용은 [리포지토리의 기본 브랜치 관리](source-branches-default-branch.md) 섹션을 참조하세요.

**중요**  
CodeCatalyst는 연결된 리포지토리에 대한 기본 브랜치의 변경 사항 감지를 지원하지 않습니다. 연결된 리포지토리의 기본 브랜치를 변경하려면 먼저 CodeCatalyst에서 연결을 해제하고 기본 브랜치를 변경한 다음 다시 연결해야 합니다. 자세한 내용은 [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결](extensions-link.md) 섹션을 참조하세요.  
리포지토리를 연결하기 전에 항상 최신 버전의 확장 프로그램을 사용하는 것이 좋습니다.

## 검색 가능한 필드 참조
<a name="search-query-language-searchable-fields"></a>

CodeCatalyst는 검색 쿼리를 입력할 때 다음 필드를 검색합니다. 별칭은 고급 쿼리 언어로 필드를 참조하는 데 사용할 수 있는 또 다른 이름입니다.

### 코드 필드
<a name="search-query-language-type-code"></a>


| 필드 | 별칭 | 설명 | 
| --- | --- | --- | 
| branchName | branch | 코드 파일이 있는 브랜치의 이름입니다. | 
| 코드 | N/A | 검색과 일치하는 소스 코드의 일부를 나타내는 코드 조각 형태의 코드 내용에 대한 정보입니다. | 
| commitId | N/A | 가장 마지막으로 업데이트된 상태의 반환된 코드 파일에 있는 커밋의 커밋 ID입니다. `branchName`에 지정된 브랜치 이름의 최신 커밋 ID일 수도 있고 아닐 수도 있습니다. | 
| commitMessage | N/A | 가장 마지막으로 업데이트된 상태의 반환된 코드 파일에 있는 커밋의 커밋 메시지입니다. `branchName`에 지정된 브랜치 이름의 최신 커밋의 커밋 메시지일 수도 있고 아닐 수도 있습니다. 커밋 메시지가 제공되지 않은 경우, 이 값은 빈 문자열이 됩니다. | 
| filePath | 경로 | 이 코드 파일의 파일 경로입니다. | 
| lastUpdatedBy | N/A | 코드 파일을 마지막으로 업데이트한 CodeCatalyst 사용자입니다. 사용자 이름을 사용할 수 없는 경우, 이 값은 Git 구성 파일에 구성된 사용자의 이메일 주소를 사용합니다. | 
| lastUpdatedById | N/A | 코드 파일을 마지막으로 업데이트한 사용자의 고유한 시스템 생성 ID입니다. 사용자 ID를 사용할 수 없는 경우, 이 값은 사용자의 이메일 주소일 수 있습니다. | 
| lastUpdatedTime | N/A | 코드 파일이 포함된 커밋으로 검색 데이터를 마지막으로 업데이트한 시간[협정 세계시(UTC) 타임스탬프 기준] | 
| projectId | N/A | 작업의 고유한 시스템 생성 ID입니다. | 
| projectName | projectNames, project | 코드 파일이 커밋된 소스 리포지토리가 포함된 프로젝트의 이름을 표시합니다. | 
| repositoryId | repoId | 리포지토리의 고유한 시스템 생성 ID | 
| repositoryName | repository, repo | 코드 파일이 커밋된 소스 리포지토리의 이름을 표시합니다. | 

### 문제 필드
<a name="search-query-language-type-issue"></a>


| 필드 | 별칭 | 설명 | 
| --- | --- | --- | 
| assigneeIds | assigneeId | 문제에 할당된 사용자의 고유한 시스템 생성 ID입니다. | 
| assignees | assignee | 문제에 할당된 사용자의 이름입니다. | 
| createdBy | N/A | 문제를 생성한 사용자의 이름을 표시합니다. | 
| createdById | N/A | 문제를 생성한 사용자의 고유한 시스템 생성 ID입니다. | 
| createdTime | N/A | 문제가 생성된 시간[협정 세계시(UTC) 타임스탬프 기준] | 
| 설명 | N/A | 문제에 대한 설명입니다. | 
| isArchived | archived | 보관된 상태에서 문제를 생성할지 여부를 나타내는 부울 값입니다. | 
| isBlocked | blocked | 문제가 차단됨으로 표시되는지 여부를 나타내는 부울 값입니다. | 
| labelIds | labelId | 문제에 대한 레이블의 고유한 시스템 생성 ID입니다. | 
| lastUpdatedBy | N/A | 문제를 마지막으로 업데이트한 사용자의 이름을 표시합니다. | 
| lastUpdatedById | N/A | 문제를 마지막으로 업데이트한 사용자의 고유한 시스템 생성 ID입니다. | 
| lastUpdatedTime | N/A | 문제가 마지막으로 업데이트된 시간[협정 세계시(UTC) 타임스탬프 기준]. | 
| priority | N/A | 문제가 할당된 경우 문제의 우선순위입니다. | 
| projectId | N/A | 작업의 고유한 시스템 생성 ID입니다. | 
| projectName | projectNames, project | 이 문제를 찾을 수 있는 프로젝트입니다. | 
| shortId | N/A | 문제에 대한 단축된 자동 증가 식별자입니다. | 
| status | N/A | 문제가 백로그 또는 보드의 열에 있는지 여부를 나타내는 문제의 상태입니다. | 
| statusId | N/A | 상태의 시스템 식별자입니다. | 
| title | N/A | 문제의 제목입니다. | 

### 프로젝트 필드
<a name="search-query-language-type-project"></a>


| 필드 | 별칭 | Description | 
| --- | --- | --- | 
| 설명 | N/A | 객체 설명입니다. | 
| lastUpdatedTime | N/A | 프로젝트 메타데이터가 마지막으로 업데이트된 시간[협정 세계시(UTC) 타임스탬프 기준]. | 
| projectName | project | 스페이스에 있는 프로젝트의 이름입니다. | 
| projectPath | N/A | 프로젝트 생성 중에 정의된 프로젝트의 URL 라우팅이 가능한 이름입니다. 프로젝트 이름이 필요한 URL에 사용됩니다. | 

### 사용자 필드
<a name="search-query-language-type-user"></a>


| 필드 | 별칭 | 설명 | 
| --- | --- | --- | 
| displayName | N/A | CodeCatalyst에서 사용자에게 사용되는 이름입니다. 표시 이름은 고유하지 않습니다. | 
| 이메일 | N/A | 사용자의 이메일 주소입니다. | 
| lastUpdatedTime | N/A | 사용자 메타데이터가 마지막으로 업데이트된 시간[협정 세계시(UTC) 타임스탬프 기준]. | 
| userName | 사용자 이름 | 사용자가 CodeCatalyst에 가입할 때 선택한 사용자 이름입니다. 표시 이름과 달리 사용자 이름은 변경할 수 없습니다. |