위치:
Microsoft Azure SQL 데이터베이스 연결
Microsoft Azure SQL 데이터베이스 커넥터를 사용하는 원격 연결을 만들어 Microsoft Azure SQL 데이터베이스의 데이터를 CRM Analytics와 동기화할 수 있습니다. Microsoft Azure Synapse Analytics 또는 전용 SQL 풀(기존 SQL DW)에 연결하려면 이 연결 대신 Microsoft Azure Synapse Analytics 연결을 추가합니다.
OAuth를 사용하여 Azure SQL에 연결
OAuth 연결을 통해 CRM Analytics Microsoft Azure SQL 커넥터를 사용하려면 Microsoft Azure 및 CRM Analytics 커넥터 설정을 구성해야 합니다.
다음 상위 수준 지침은 관련 단계를 탐색하는 데 도움이 됩니다. 네트워크 보안 또는 IT 부서에 문의하여 조직의 보안 요구 사항과 일치하는 구성에 대한 도움을 받으십시오.
Microsoft Azure 포털에서 연결된 앱을 구성합니다. 자세한 내용은 Entra ID(Azure AD) 응용 프로그램 만 만들기를 참조하십시오.
이 구성 프로세스 동안 응용 프로그램(클라이언트) ID 및 디렉터리(테넌트) ID 값을 기록하십시오. 연결 설정의 클라이언트 ID 및 Azure 테넌트 값입니다.
클라이언트 암호 탭의 새 클라이언트 암호에서 클라이언트 암호 커넥터 값을 가져옵니다. 암호 ID가 아닌 값을 사용합니다. 클라이언트 암호 값은 한 번만 표시되므로 기록하지 않을 경우 값을 가져오려면 다른 클라이언트 암호를 만들어야 합니다.
- Azure SQL Server를 구성하여 Micrsoft Entra 전용 인증을 사용하거나 SQL 및 Microsoft Entra 인증을 모두 사용하십시오. Microsoft Entra 관리자가 구성되어 있는지 확인합니다. 서버에 보안 아래의 네트워크 섹션에 구성된 방화벽 규칙이 필요합니다. 규칙의 경우 시작 IP 값을 0.0.0.0로, 종료 IP 값을 255.255.255.255로 설정하고 저장합니다.
- Microsoft Entra 인증에 대해 구성한 SQL 서버와 일치하는 SQL 데이터베이스를 선택하여 Azure SQL 데이터베이스를 구성합니다. 쿼리 편집기에서 Microsoft Entra 관리자 자격 증명을 사용하여 인증하고 다음 SQL 문을 실행하여
[my-sql-connector]를 연결된 앱의 표시 이름으로 대체합니다.CREATE USER [my-sql-connector] FROM EXTERNAL PROVIDER;ALTER ROLE db_datareader ADD MEMBER [my-sql-connector];ALTER ROLE db_datawriter ADD MEMBER [my-sql-connector];
모든 구성 단계가 올바르게 구현되었는지 확인하려면
SELECT name, type_desc FROM sys.database_principals WHERE name = "[my-sql-connector]";를 실행하고 결과에 연결된 앱 이름과 함께 하나의 행이 포함되어 있는지 확인합니다.
연결 만들기
- 데이터 관리자 연결 탭에서 새 연결을 클릭합니다.
- 커넥터의 이름을 클릭하고 다음을 클릭합니다.
- 커넥터 설정을 입력합니다.
- 설정 유효성을 검사하고 소스에 대한 연결을 시도하려면 저장 후 테스트를 클릭합니다. 연결이 실패하면 CRM Analytics가 가능한 원인을 표시합니다.
달리 명시되지 않는 한 모든 설정에는 값이 필요합니다.
| 연결 설정 | 설명 |
|---|---|
| 연결 이름 | (필수) 연결을 식별합니다. 다양한 연결을 쉽게 구분할 수 있도록 지원하는 규칙을 사용합니다. |
| 개발자 이름 | (필수) 연결의 API 이름입니다. 이 이름에 공백을 포함할 수 없습니다. 이 연결을 통해 추출된 데이터를 참조하기 위해 레시피에서 API 이름을 사용합니다. 연결을 만든 후에는 개발자 이름을 변경할 수 없습니다. |
| 설명 | (필수) 연결에 대한 설명입니다. |
| 인증 유형 | (필수) 엔트라 전용 인증에 OAuth를 입력합니다. 표준 SQL 인증의 경우 암호를 입력합니다. |
| JDBC 연결 URL | (필수) 데이터베이스의 URL 스키마입니다. 입력. 형식: <host name>:<port> 호스트 이름을 형성하려면 서버 이름에 .database.windows.net을 추가합니다. 서버 이름은 Microsoft 문서에서 찾을 수 있습니다. 예를 들어, 서버의 이름이 Blue_server이면 호스트 이름은 Blue_server.database.windows.net입니다. 기본 포트는 1433입니다. URL 예: |
| 데이터베이스 | (필수) Microsoft Azure SQL 데이터베이스 이름입니다. |
| 스키마 | (선택 사항) 데이터베이스의 스키마 이름입니다. JDBC 연결 URL에서 충분한 컨텍스트를 제공하지 않을 경우 스키마 이름을 입력해야 합니다. 기본값은 dbo입니다. |
| 사용자 이름 | 암호 인증에 필요합니다. SQL 데이터베이스 로그인의 사용자 이름입니다. 입력. 형식: <username>@<host name> 호스트 이름을 형성하려면 서버 이름에 .database.windows.net을 추가합니다. 서버 이름은 Microsoft 문서에서 찾을 수 있습니다. 예를 들어, 서버의 이름이 Blue_server이면 호스트 이름은 Blue_server.database.windows.net입니다. |
| 암호 | 암호 인증에 필요합니다. SQL 데이터베이스 로그인의 암호입니다. |
| 클라이언트 ID | OAuth 인증에 필요합니다. 연결된 앱의 Microsoft Azure 응용 프로그램 ID입니다. |
| 고객 암호 | OAuth 인증에 필요합니다. 연결된 앱의 Microsoft Azure 클라이언트 암호 값입니다. |
| Azure 테넌트 | OAuth 인증에 필요합니다. 연결된 앱의 Microsoft Azure 디렉터리 ID입니다. |
CRM Analytics에 동기화된 데이터 필터링
데이터 동기화 필터를 사용하여 불필요하거나 민감한 데이터를 CRM Analytics에 대한 동기화에서 제외할 수 있습니다. 필터는 소스 개체에서 실행되며 필요한 데이터만 CRM Analytics로 끌어와 데이터 동기화 속도를 높입니다. 이후에 제외된 데이터를 사용하려면 데이터 동기화 필터가 아닌 레시피 필터를 사용하여 데이터 집합에 기록되는 데이터를 제한합니다.
- 데이터 관리자에서 연결 탭을 클릭합니다.
- 필터링할 개체와 연결된 연결을 선택합니다.
- 필터링할 개체의 이름을 클릭합니다.
- 데이터 동기화 필터를 클릭합니다.
- 필터를 입력합니다.
- 저장을 클릭합니다.
Microsoft Azure SQL 데이터베이스 커넥터의 경우 Azure SQL 데이터베이스와 WHERE 문서에 설명된 구문에 필터를 입력합니다.
Microsoft Azure SQL 데이터베이스 커넥터를 작동할 때 다음 동작에 유의하십시오.
- 연결된 개체 이름은 문자로 시작하고 문자, 숫자 또는 밑줄만 포함해야 합니다. 개체 이름은 밑줄로 끝나서는 안 됩니다.
- 영숫자, 점, 밑줄 또는 대시 문자로 조합된 필드 이름만 지원됩니다. 커넥터에 괄호와 같은 다른 특수 문자가 포함된 필드 이름이 있을 경우 동기화에 실패합니다.
- 커넥터는 최대 1억 개의 행 또는 개체당 50GB까지 동기화할 수 있습니다.
