Личное выводное подключение Snowflake

Принцип работы выводных коннекторов CRM Analytics с узлами output

Выводные коннекторы CRM Analytics позволяют записывать результат рецепта во внешнюю систему для дальнейшего анализа, автоматизации бизнеса и хранения. После настройки выводного коннектора в источник данных, создайте рецепт в подготовке данных. Добавьте узел output к рецепту, выберите выводное подключение и выберите имя таблицы Snowflake в списке объектов. При выполнении рецепта CRM Analytics записывает выводной набор данных в выбранную таблицу. При повторном запуске рецепта ранее записанные данные удаляются и новые данные записываются.Создание личного ключа Snowflake и пароля личного ключа посредством документации личного ключа Snowflake. Если вы выберете ротацию личного ключа Snowflake, вручную обновите свойства подключения посредством нового ключа.

Предварительные требования

• Требуется Salesforce Private Connect. Для виртуальных личных подключений требуется дополнительная лицензия PrivateConnect.
• Необходимо настроить Snowflake для личной ссылки, чтобы узнать, как это сделать, см. руководство Snowflake AWS PrivateLink и Snowflake.

Для получения помощи в настройке этого подключения в соответствии с требованиями безопасности организации обратитесь в отдел безопасности сети или ИТ.

Разрешить добавление в список организаций Salesforce AWS для Snowflake Private Connect

Чтобы убедиться, что ваша организация AWS включена в список разрешенных для личного подключения Salesforce, см. «Проверка организации Salesforce AWS для личного подключения».

Подключение к Snowflake с помощью OAuth

Чтобы использовать OAuth 2.0 для личных подключений Snowflake, см. Настройка OAuth и поставщика для личного подключения Snowflake.

Создание исходящего подключения к сети

Чтобы создать исходящее сетевое подключение, см. Создание исходящего сетевого подключения.

Создайте еще одно подключение для интегрированного хранилища S3 Snowflake. Это подключение используется, когда запрос возвращает большие объемы данных. Snowflake разделяет данные на несколько файлов и помещает их в интегрированное хранилище S3 для загрузки. Для исходящих подключений S3 требуется дополнительная лицензия PrivateConnect.

1. Найдите имя службы конечной точки VPC S3 в консоли AWS.
2. Нажмите «Создать исходящее подключение».
3. Выберите AWS PrivateLink и нажмите «Далее».
4. Введите имя исходящего подключения S3 аналогично имени основного подключения, дополненного «_S3». Например, если основное подключение называется SnowflakeVPCOutbound, назовите подключение S3 SnowflakeVPCOutbound_S3.
5. В поле «Имя службы конечной точки VPC» введите имя службы конечной точки, обнаруженное в консоли AWS.
6. В поле «Регион» выберите регион AWS, в котором выполняется Snowflake Private Connect.
7. Выберите «Да, я хочу инициализировать подключение сейчас».
8. Сохраните подключение.

Убедитесь, что статус подключений готов для обоих подключений. В противном случае попробуйте синхронизировать подключения.

Создание внешних регистрационных данных

1. Введите строку «Именованные» в поле «Быстрый поиск» меню «Настройка» и выберите пункт «Именованные регистрационные данные».
2. Во вкладке «Внешние регистрационные данные» нажмите «Создать».
3. Заполните поля «Метка» и «Имя».
4. Для протокола проверки подлинности выберите «Нет проверки подлинности», если вы не используете OAuth.
   
5. Если вы используете OAuth, выберите OAuth 2.0. Потом выберите «Поток обозревателя» для типа потока и внешнего поставщика удостоверений для поставщика удостоверений.
   
6. Сохраните внешние регистрационные данные.
7. Открыть новые внешние регистрационные данные
8. В разделе «Основные» нажмите «Создать».
9. Введите SnowflakeVPCOAuthPrincipalAccess для имени параметра, 1 для последовательности и Named Principal для типа удостоверения.
10. Если вы используете OAuth 2.0, задайте область. В области введите два значения, разделенные пробелом. Первое значение области - session:role:target role, соответствующее настройке области, выполненной на этапе настройки Okta. Это предоставляет надлежащий доступ к данным на основе роли. Второе значение области - offline_access, позволяющее возвращать маркер обновления из Okta.
    
11. Сохраните основной. Найдите меню действий для основного и «Проверка подлинности»
    

    Данное действие открывает окно обозревателя для входа в Okta. После успешной проверки подлинности обозреватель перенаправляется в Salesforce, а статус проверки подлинности обновляется на «Настроено». Если статус не обновлен, просмотрите основные параметры области и настройки Okta.

Теперь обновите профиль пользователя посредством основного доступа к внешним регистрационным данным.

1. Введите строку «Профили» в поле «Быстрый поиск» меню «Настройка» и выберите пункт «Профили».
2. Выберите профиль для пользователя интеграции Analytics Cloud.
3. Нажмите «Включенный основной доступ к внешним регистрационным данным» вверху страницы профиля.
4. Нажмите «Правка» и добавьте SnowflakeVPCOAuthExtCred - SnowflakeVPCOAuthPrincipalAccess.
5. Нажмите кнопку «Сохранить».

Создание именованных регистрационных данных

1. В Snowflake определите имя организации Snowflake в поле URL-адреса организации SYSTEM$GET_PRIVATELINK_CONFIG.
2. Введите строку «Именованные» в поле «Быстрый поиск» меню «Настройка» и выберите пункт «Именованные регистрационные данные».
3. Во вкладке именованных регистрационных данных нажмите «Создать».
4. Заполните поля «Метка» и «Имя».
5. В качестве URL-адреса введите https://<your Snowflake account name.your AWS region>. privatelink.snowflakecomputing.com.
6. Выберите созданные внешние регистрационные данные и исходящее сетевое подключение.
   
7. Сохраните именованные регистрационные данные.

Включение и добавление выводного коннектора Snowflake Private

1. В диспетчере данных откройте вкладку «Подключения».
2. Щелкните «Новая связь».
3. Нажмите «Личный», выберите «Личный коннектор Snowflake (вывод)», потом нажмите «Далее».
4. Введите параметры подключения, как описано в разделе «Параметры подключения».
5. Нажмите кнопку «Сохранить и тестировать». «Сохранить и проверить» проверяет ваши параметры посредством подключения к источнику. Если подключение не удается, CRM Analytics указывает возможные причины.

Все параметры требуют значения, если не указано иначе.

Параметры подключения	Описание
Имя подключения	Идентифицирует соединение. Используйте обозначения, которые позволят вам легко отличать различные типы соединений.
Имя разработчика	Название API для соединения. Это имя не может содержать пробелы. Вы не можете редактировать имя разработчика после создания соединения.
Описание	Описание подключения
Тип проверки подлинности	Тип проверки подлинности, используемый для этого подключения. Допустимые значения: OAuth, Password или PrivateKey. PrivateKey рекомендуется в качестве наиболее безопасного варианта. При использовании OAuth введите значение в поле «Именованные регистрационные данные». При использовании Password введите значение в поля «Имя пользователя» и «Пароль». При использовании PrivateKey введите значение в поля «Имя пользователя», «Личный ключ» и «Пароль личного ключа»
Именованные регистрационные данные	Поле «Имя» из именованных регистрационных данных, сохраненных в организации Salesforce.
Username	Имя пользователя для организации Snowflake.
Личный ключ	Необязательный параметр*. Личный ключ, связанный с организацией Snowflake. Примечание Необходимо использовать зашифрованный личный ключ и пароль, созданный посредством расширенного стандарта шифрования (AES). Подробные сведения см. в разделе «Проверка подлинности пары ключей и ротация пары ключей» справки Snowflake. При использовании команды openssl для создания зашифрованного ключа обязательно замените des3 aes256, чтобы обеспечить использование расширенного шифрования.
Пароль личного ключа	Необязательный параметр*. Пароль, связанный с указанным личным ключом.
Warehouse	Имя склада Snowflake. Этот параметр чувствителен к регистру, поэтому введите значение так, как оно отображается в Snowflake.
Роль	Необязательный параметр. Роль Snowflake присваивается пользователю, используемому для подключения.
Database	Имя базы данных Snowflake. Этот параметр чувствителен к регистру, поэтому введите значение так, как оно отображается в Snowflake.
Schema	Имя схемы Snowflake. Этот параметр чувствителен к регистру, поэтому введите значение так, как оно отображается в Snowflake.

*Введите пароль или личный ключ и пароль личного ключа. Узнайте больше о личных ключах в документации по «Личный ключ Snowflake».

Принудительное внедрение данных в Snowflake

После настройки выводного коннектора Snowflake у вас есть два варианта переноса данных в Snowflake из CRM Analytics. Для внедрения дополненных и трансформированных данных создайте рецепт в подготовке данных, который объединяет и трансформирует данные для внедрения в Snowflake. Добавьте узел output и настройте его на использование выводного коннектора Snowflake.

1. Выбрать для записи в выводное подключение.
2. Выбрать имя подключения созданного выводного подключения Snowflake.
3. Нажмите кнопку «Применить».
4. Сохраните рецепт.

Чтобы форсировать исходные данные без дополнения или трансформации, используйте Sync Out для Snowflake. Данные внедряются при каждом запуске синхронизации данных. Инструкция по подготовке данных не используется. Учитывайте данные алгоритмы, работая с выводным коннектором Snowflake и используя узел output инструкции по подготовке данных.

• Вы можете использовать выводное подключение несколько раз в каждой инструкции, но каждый узел output должен использовать другой объект. Ограничение на выполнение коннектора применяется к каждому узлу вывода, и каждый узел вывода подчиняется скользящему ограничению 24 часов. Для повторного переноса из того же рецепта добавьте еще одно подключение с теми же регистрационными данными
• Выводные подключения доступны только для рецептов, созданных с помощью подготовки данных.
• Когда данные предыдущего выполнения удаляются в подготовке к текущему выполнению, более ранние версии выводного набора данных будут недоступны. Настройте процессы для копирования или использования вывода после каждого выполнения.