Salesforce Setup 메뉴에서 Integrations > Named Query API를 보면, 뭔가 개발자나 외부 시스템과 연결하는 기능 같아서 어렵게 느껴질 수 있어요. 하지만 천천히 살펴보면, Admin 입장에서도 기본 개념만 알아두면 좋답니다.
이 기능은 무엇인가
Named Query API는 Salesforce에서 외부 시스템이 데이터를 요청할 때, 미리 정의된 쿼리를 이름으로 호출할 수 있게 해주는 기능이에요. 쉽게 말해서, "이름 붙인 쿼리"를 만들어 두고, 외부에서 그 이름만 불러서 데이터를 받아갈 수 있게 하는 거죠.
언제 사용하는가
이 기능은 주로 Salesforce와 외부 시스템(예: 웹사이트, 앱, 다른 데이터베이스 등)이 데이터를 주고받을 때 사용돼요. 예를 들어, 외부 시스템에서 Salesforce의 고객 정보를 가져오고 싶을 때, 미리 만들어둔 Named Query를 호출해서 필요한 데이터만 깔끔하게 받아올 수 있어요.
- 외부 개발자나 파트너가 Salesforce 데이터에 접근할 때
- 복잡한 SOQL 쿼리를 직접 짤 필요 없이, 미리 정해진 쿼리만 호출하게 하고 싶을 때
- 보안상, 허용된 데이터만 외부로 노출하고 싶을 때
어떻게 이해하면 쉬운가
이 기능을 쉽게 이해하려면, "정해진 질문에만 대답하는 창구"라고 생각해보세요. 예를 들어, 회사 대표 전화번호로 문의가 오면, 미리 준비된 답변만 해주는 것처럼, Named Query도 Salesforce에 미리 만들어둔 쿼리만 외부에서 사용할 수 있게 해주는 거예요.
이렇게 하면, 외부에서 아무 쿼리나 마음대로 실행할 수 없고, 관리자가 허락한 쿼리만 사용할 수 있어서 보안에도 도움이 돼요.
예시
- 마케팅팀이 운영하는 외부 웹사이트에서 "우리 회사의 최신 이벤트 목록"만 보여주고 싶을 때, Salesforce Admin이 Named Query로 "최신 이벤트" 쿼리를 만들어 두면, 웹사이트는 그 Named Query만 호출해서 데이터를 받아올 수 있어요.
- 파트너사가 우리 Salesforce에서 특정 제품 정보만 받아가야 할 때, 해당 제품 정보를 조회하는 Named Query를 만들어서, 그 이름으로만 접근하게 할 수 있어요.
—
참고로, Named Query API는 모든 Salesforce org에서 기본으로 보이지 않을 수도 있고, API 사용 권한이나 버전에 따라 메뉴 위치나 사용 가능 여부가 다를 수 있어요. 만약 메뉴가 보이지 않거나, 옵션이 다르게 나온다면, Salesforce 버전이나 라이선스, 또는 권한 설정을 확인해보세요. 궁금한 점이 있으면 Salesforce 공식 문서나 Trailhead에서 "Named Query"를 검색해보는 것도 추천해요!