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 \$1 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>

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

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

**검색 범위 좁히기** - 검색은 대/소문자를 구분하지 않습니다. 소문자로만 검색하면 쿼리에서 대소문자 변경에 따른 단어 분할이 일어나지 않습니다. 예를 들어 `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에 가입할 때 선택한 사용자 이름입니다. 표시 이름과 달리 사용자 이름은 변경할 수 없습니다.  |