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

# Salesforce 데이터 소스에 연결
<a name="salesforce-AMG-datasource"></a>

**참고**  
이 데이터 소스는 Grafana Enterprise 전용입니다. 자세한 내용은 [Enterprise 플러그인에 대한 액세스 관리](upgrade-to-enterprise-plugins.md) 단원을 참조하십시오.  
또한 버전 9 이상을 지원하는 워크스페이스에서 이 데이터 소스를 사용하려면 적절한 플러그인을 설치해야 할 수 있습니다. 자세한 내용은 [플러그인을 사용하여 워크스페이스 확장](grafana-plugins.md) 단원을 참조하십시오.

Salesforce 데이터 소스를 사용하면 Amazon Managed Grafana 내에서 Salesforce의 데이터를 시각화할 수 있습니다.

이 데이터 소스를 사용하려면 [Salesforce](https://www.salesforce.com/) 계정 및 [Salesforce 연결 앱](https://help.salesforce.com/articleView?id=sf.connected_app_overview.htm&type=5)이 있어야 합니다.

## 알려진 제한 사항
<a name="salesforce-known-limitations"></a>
+  임시 필터는 아직 지원되지 않습니다.
+  SOQL 쿼리와 SOQL을 통해 액세스할 수 있는 데이터만 현재 지원됩니다. SOSL 및 SAQL 쿼리 형식은 아직 지원되지 않습니다.

## 필수 설정
<a name="salesforce-settings"></a>

다음 설정이 필요합니다.

**참고**  
플러그인은 현재 OAuth 2.0 사용자 이름-암호 흐름을 사용합니다. 연결된 앱에서 필요한 콜백 URL은 사용되지 않습니다. 따라서 유효한 URL로 설정할 수 있습니다.


|  이름  |  설명  | 
| --- | --- | 
|  Enable OAuth settings  |  OAuth를 활성화하려면 이를 선택해야 합니다. | 
|  Callback URL  |  이 플러그인에서는 사용되지 않으므로 유효한 URL을 지정할 수 있습니다. | 
|  Selected OAuth Scopes (minimum requirements)  | 데이터(api)에 액세스하고 데이터를 관리합니다. | 
|  Require Secret for Refresh Token Flow  |  이를 활성화하거나 비활성화할 수 잇습니다. | 

## 데이터 소스 추가
<a name="salesforce-adding-the-data-source"></a>

1.  Amazon Managed Grafana 워크스페이스에서 Grafana 콘솔을 열고 로그인되었는지 확인합니다.

1.  사이드 메뉴의 **구성**(톱니 아이콘) 아래에서 **데이터 소스**를 선택하세요.

1.  **데이터 소스 추가**를 선택합니다.
**참고**  
 사이드 메뉴에 **데이터 소스** 링크가 표시되지 않으면 현재 사용자에게 `Admin` 역할이 없다는 의미입니다.

1.  데이터 소스 목록에서 **Salesforce**를 선택하세요.

1. 다음 정보를 입력합니다.
   + **사용자 이름**에 Salesforce를 연결하고 쿼리하는 데 사용할 Salesforce 계정의 사용자 이름을 입력하세요.
   + **암호**에 해당 사용자 암호를 입력합니다.
   + **보안 토큰 **에 해당 사용자의 보안 토큰을 입력합니다.
   + **소비자 키**에 소비자 키를 입력하여 Salesforce에 연결하세요. Salesforce 연결된 앱에서 이 정보를 얻을 수 있습니다.
   + **소비자 보안 암호**에 Salesforce에 연결하는 데 사용할 소비자 보안 암호를 입력하세요. Salesforce 연결된 앱에서 이 정보를 얻을 수 있습니다.
   + **샌드박스 사용**에서 Salesforce 샌드박스를 사용하려면 이 옵션을 선택하세요.

## Salesforce 데이터 소스 쿼리
<a name="salesforce-query"></a>

쿼리 편집기는 쿼리 빌더 및 SOQL 편집기 모드를 지원합니다. SOQL은 [ Salesforce Object Query Language](https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_soql.htm)의 약어입니다.

### 쿼리 빌더(SOQL 빌더)
<a name="salesforce-query-builder"></a>

쿼리 빌더는 SOQL 쿼리를 빌드하기 위한 사용자 친화적 인터페이스입니다. SOQL 쿼리 작성에 익숙하지 않은 경우 이 모드를 사용하여 SOQL을 빌드해 Salesforce 객체를 쿼리할 수 있습니다. 쿼리 빌더의 **FROM** 필드는 Salesforce에 있는 하나 이상의 엔터티를 나타냅니다. 쿼리 빌더의 다른 작업을 수행하기 전에 **FROM** 필드를 선택해야 합니다. **FROM** 필드를 선택한 후 빌더 모드를 선택해야 합니다. SOQL 빌더는 현재 다음 모드를 지원합니다.
+ `List` - 선택한 테이블/Salesforce의 필드를 포함하는 항목을 나열합니다. 이 모드를 사용하여 '이 회계 분기에 생성된 기회 목록과 함께 해당 이름, 값 및 단계 표시'와 같은 결과를 확인합니다.
+ `Aggregate` - 엔터티의 항목을 집계합니다. 이 모드를 사용하여 '지난 달에 생성된 기회 계산' 또는 '스테이지 이름별로 그룹화된 기회의 총 가치'와 같은 결과를 확인합니다.
+ `Trend` - 시간 경과에 따른 집계된 결과를 표시합니다. 이 모드를 사용하여 'CreatedDate별 기회 수 계산' 또는 '기회의 마감 날짜별로 그룹화된 총 가치 합계'와 같은 결과를 확인합니다.

쿼리 편집기에서 `Entity/FROM` 및 **모드**를 선택한 후 다음 옵션을 사용하여 쿼리를 빌드합니다.


|  **필드**  |  **적용 대상**  |  **설명**  | 
| --- | --- | --- | 
|  SELECT |  ALL  |  보려는 필드 목록을 선택하세요. 집계 또는 추세 보기에서 값을 집계할 방법도 선택합니다. | 
|  WHERE |  ALL  |  (선택 사항) 필터 조건을 지정합니다. 결과는 선택한 조건에 따라 필터링됩니다. | 
|  ORDER BY |  LIST, AGGREGATE  |  (선택 사항) 결과에 사용할 필드 이름과 정렬 순서를 선택합니다. | 
|  LIMIT |  LIST, AGGREGATE  |  (선택 사항) 반환된 결과 수를 제한합니다. 기본값은 100입니다. | 
|  GROUP BY |  AGGREGATE  |  (선택 사항) 집계된 값을 특정 필드로 분할하려면 필드를 선택합니다. | 
|  TIME FIELD |  TREND  |  결과를 그룹화할 날짜 필드를 지정합니다. 결과는 Grafana의 시간 선택기 범위에 따라 필터링됩니다. | 

쿼리 편집기에서 이전 필드를 구성하면 쿼리 편집기 아래에 생성된 SOQL의 미리 보기도 표시됩니다. 쿼리 빌더의 제한 사항으로 인해 차단된 경우 생성된 SOQL 쿼리를 사용자 지정할 수 있는 SOQL 편집기로 안전하게 전환할 수 있습니다.

### SOQL 편집기
<a name="salesforce-SOQL-editor"></a>

원시 SOQL 편집기에서는 원시 SOQL 쿼리를 통해 Salesforce 객체를 쿼리하는 옵션을 제공합니다. SOQL 편집기에서는 테이블 및 해당 필드당 사용 가능한 엔터티와 같은 자동 완성 제안을 제공합니다. SELECT 또는 WHERE 다음에 Ctrl\$1Space를 사용하여 테이블당 사용 가능한 엔터티를 확인합니다. 엔터티 이름 뒤에 점을 입력하면 사용 가능한 필드를 볼 수 있습니다.

**단축키**

CTRL \$1 SPACE를 사용하여 사용 가능한 컨텍스트 옵션을 보여주는 코드 완료를 표시합니다.

CMD \$1 S는 쿼리를 실행합니다.

**시계열로 쿼리**

날짜 필드를 time으로, 지표 필드를 metric으로 각각 별칭을 지정하여 시계열 쿼리를 수행한 다음, 지표 및 날짜별로 그룹화합니다. 다음은 예제입니다.

```
SELECT sum(Amount) amount, CloseDate time, Type metric from Opportunity
group by Type, CloseDate
```

**매크로**

대시보드 시간 범위별로 필터링하기 위해 SOQL 쿼리에서 매크로를 사용할 수 있습니다.
+ `$__timeFrom` - `time` 데이터 유형으로 변환된 현재 활성 시간 선택의 시작으로 대체됩니다.
+ `$__timeTo` - `time` 데이터 유형으로 변환된 현재 활성 시간 선택의 끝으로 대체됩니다.
+ `$__quarterStart` - 회계 분기의 시작(SalesForce 회계 연도 설정에서 파생됨).
+ `$__quarterEnd` - 회계 분기의 끝(SalesForce 회계 연도 설정에서 파생됨).

```
SELECT UserId, LoginTime from LoginHistory where LoginTime > $__timeFrom
```

## 템플릿 및 변수
<a name="salesforce-templates"></a>

새 Salesforce 쿼리 변수를 추가하려면 [쿼리 변수 추가](variables-types.md#add-a-query-variable) 섹션을 참조하세요. Salesforce 데이터 소스를 데이터 소스로 사용합니다. 여기에서 모든 SOQL 쿼리를 사용할 수 있습니다.

사용자 ID 및 사용자 이름과 같은 이름/값 페어를 사용하려면 SOQL 쿼리에서 두 필드를 반환합니다. 첫 번째 필드가 ID로 사용됩니다. 쿼리 편집기 SOQL에서 키(ID 등)를 기준으로 필터링하려는 경우 이 작업을 수행합니다.

변수 구문을 사용하여 SOQL 쿼리에서 변수를 사용합니다. 자세한 내용은 [변수 구문](templates-and-variables.md#variable-syntax) 단원을 참조하십시오.