Gérer Data Share avec un compte NiCE Snowflake

La configuration deData Share diffère selon que vous utilisez un compte NiCE Snowflake ou si vous avez votre propre compte Snowflake. Vous faites ce choix avant l'installation. Si vous changez d'avis après l'installation, vous pouvez le changer, mais vous devez travailler avec votre Représentant de compte pour le faire.

Conditions préalables

  • Si ce n’est déjà fait, contactez votre Représentant de compte pour activer Data Share. Dites-leur que vous souhaitez créer un nouveau compte Snowflake.

  • Décidez si vous souhaitez configurer une intégration avec un outil de reporting externe. Si vous souhaitez extraire vos données dans un outil externe, vous devez créer un utilisateur de service Snowflake, expliqué dans les étapes ci-dessous.

  • Vous devez définir les adresses IP via lesquelles vos données seront accessibles. Vous devrez peut-être rassembler une liste avant d’effectuer les étapes de cette page. Si vous rencontrez des problèmes d'accès aux données, vous devrez peut-être ajouter à la fois le WAN (IP publique) et le LAN (IP locale/privée) pour chaque utilisateur ou application qui accédera aux données.

Créer un NiCE Snowflake compte

Autorisations requises : Partage de données cloud Activé

Les étapes suivantes vous guident tout au long du processus de création d'un compte principal Snowflake que vous pouvez utiliser pour vous connecter via l'interface Snowflake. Il vous aide également à créer un utilisateur de service Snowflake, si vous en avez besoin. Un utilisateur de service vous permet de configurer un accès programmatiqueFermé Réalisation d’une action à l’aide d’un code informatique plutôt qu’un processus manuel ou une interface utilisateur. Il s’agit d’automatiser des tâches, puisqu’elles peuvent être accomplies par un programme ou un script, plutôt qu’un humain. à vos données avec un applicationexterne, comme un outil de reporting BI. L'utilisateur du service dispose d'une authentification par paire de clés pour permettre au application d'accéder aux données ; vous pouvez le considérer comme un compte utilisateur pour le application. Si vous avez besoin d'aide avec ce type d'authentification, contactez votre groupe informatique ou votre NiCE Représentant de compte.

  1. Cliquez sur le sélecteur d'applications icône du sélecteur d'applications et sélectionnez Admin.

  2. Accédez à Configuration du compte > Data Share.

  3. Cliquez sur Créer un compte.

  4. Dans la fenêtre de confirmation, sélectionnez Oui je suis d’accord et cliquez sur Confirmer. Le processus de création de compte peut prendre jusqu’à 45 minutes. Vous pouvez continuer à utiliser CXone Mpower pour d’autres tâches pendant que vous patientez.

  5. Consultez régulièrement les Notifications Icône de cloche blanche sur fond bleu indiquant des notifications dans la barre d’outils, au sommet de l’écran. Lorsqu’une nouvelle notification s’affiche, vérifiez que la création du compte a réussi. Si la création du compte a échoué, ne faites pas de nouvelle tentative. Contactez plutôt l’assistance CXone Mpower.

    Capture d’écran d’une notification Compte Snowflake créé dans CXone.

  6. À partir de la page Data Share, ajoutez les adresses IP et les plages d'adresses IP auxquelles vous souhaitez donner accès à vos données Snowflake. Si vous n'ajoutez aucune adresse IP, vous ne pourrez pas accéder à votre compte Snowflake.

    CXone Mpower ne vérifie pas que vos entrées sont des adresses IP réelles. Il vérifie simplement que les formats d'entrée sont valides. Lorsqu'un utilisateur se connecte à votre compte NiCE Snowflake, CXone Mpower vérifie que les tentatives d'extraction de données proviennent de l'une des adresses IP de votre liste d'autorisation.

    Capture d’écran de la section Plage IP de la page Partage de données. Elle contient une plage IP vérifiée avec le bouton Soumettre activé.

    1. Sur la page Data Share dans CXone Mpower, descendez jusqu’à Plage IP.
    2. Dans la zone de texte, saisissez les adresses IP et les plages d’adresses IP que vous voulez ajouter à la liste d’autorisation dans la notation CIDR. Si vous en ajoutez plusieurs à la fois, séparez chaque entrée par une virgule.
    3. Cliquez sur Ajouter.
    4. Une fois que CXone Mpower a confirmé que chaque adresse IP et plage est un format valide, cliquez sur Soumettre pour les appliquer à votre compte NiCE Snowflake.

  7. Si vous souhaitez qu'un application accède à vos données, créez un utilisateur de service Snowflake :

    1. Dans la section Utilisateur du service, cliquez sur Générer une paire de clés. Une fenêtre contextuelle s'ouvre.

    2. Pour en savoir plus sur l'authentification de cet utilisateur de service, cliquez sur En savoir plus pour ouvrir le contenu d'aide en ligne Snowflake .

    3. Cliquez sur Générer une paire de clés. Après un moment, votre clé privée apparaît. Copiez ceci et enregistrez-le sur votre ordinateur.

    4. Cliquez sur Fermer. Notez l'entrée CXONE_DATA_SHARE_SERVICE_USER générée pour Nom d'utilisateur.

    5. Copiez le nom d'utilisateur et enregistrez-le avec la clé privée. Vous devez les saisir lors de la configuration ou de la mise à jour de l'authentification pour votre applicationexterne. Il s’agit d’informations d’identification sensibles que vous devez gérer et stocker en toute sécurité.

  8. Créez un mot de passe pour votre compte principal Snowflake :

    1. Sur la page Data Share, cliquez sur Générer un nouveau lien.

    2. Lorsque le lien s’affiche dans une fenêtre contextuelle, cliquez sur Copier le lien.

    3. Collez le lien dans une nouvelle fenêtre ou un nouvel onglet de navigateur.

    4. Définissez votre mot de passe Snowflake.

  9. Connectez-vous à Snowflake :

    1. Sur la page Data Share, copiez l’URL d’accès.

    2. Collez cette URL dans une nouvelle fenêtre ou un nouvel onglet de navigateur.

    3. Connectez-vous à Snowflake. Utilisez le Nom d’utilisateur de Snowflake CXone Mpower et le mot de passe que vous venez de créer.

  10. Une fois connecté, cliquez sur CXONE_DATASHARE_\u003cBU_ID\u003e sur la gauche pour commencer à naviguer dans les CXone Mpower objets de données partagés.

Gérer le compte CXone Mpower Snowflake

Lorsque vous créez un compte Snowflake via CXone Mpower, vous devenez dépendant de NiCE pour certaines tâches de maintenance du compte. Vous devez contacter votre Représentant de compte si vous souhaitez :

  • modifier la tâche de l’entrepôt de données ;

  • Réinitialisez votre mot de passe pour votre compte principal Snowflake si vous le laissez expirer. Le mot de passe expire 90 jours après votre changement de mot de passe le plus récent.

Si vous utilisez Data Share avec un compte NiCESnowflake et que vous ne souhaitez plus ces dépendances, contactez votre Représentant de compte pour obtenir de l'aide pour organiser votre propre contrat Snowflake.

Gestion de la liste d’autorisation d’accès aux données

Autorisations requises: Partage de données cloud activé

Utilisez cette section pour ajouter des adresses IP et des plages d’adresses IP à votre liste d’autorisation. Cela améliore la sécurité en limitant l'accès aux données aux seuls utilisateurs se connectant à partir des adresses IP que vous spécifiez.Snowflake

CXone Mpower ne vérifie pas que vos entrées sont des adresses IP réelles. Il vérifie simplement que les formats d'entrée sont valides. Lorsqu'un utilisateur se connecte à votre compte NiCE Snowflake, CXone Mpower vérifie que les tentatives d'extraction de données proviennent de l'une des adresses IP de votre liste d'autorisation.

Capture d’écran de la section Plage IP de la page Partage de données. Elle contient une plage IP vérifiée avec le bouton Soumettre activé.

  1. Cliquez sur le sélecteur d'applications icône du sélecteur d'applications et sélectionnez Admin.

  2. Accédez à Configuration du compte > Data Share.

  3. Sur la page Data Share dans CXone Mpower, descendez jusqu’à Plage IP.
  4. Dans la zone de texte, saisissez les adresses IP et les plages d’adresses IP que vous voulez ajouter à la liste d’autorisation dans la notation CIDR. Si vous en ajoutez plusieurs à la fois, séparez chaque entrée par une virgule.
  5. Cliquez sur Ajouter.
  6. Une fois que CXone Mpower a confirmé que chaque adresse IP et plage est un format valide, cliquez sur Soumettre pour les appliquer à votre compte NiCE Snowflake.

Intégration avec le stockage

Autorisations requises : Partage de données cloud Activé

Utilisez cette section si vous souhaitez exporter les données de Data Share vers votre propre dispositif de stockage. Cela vous permet de copier CXone Mpower données de votre NiCE compte Snowflake vers votre propre compartiment S3.AWS À partir de là, vous pouvez télécharger vos données dans votre propre entrepôt de données ou outil d’analyse décisionnelle.

Avant d’effectuer cette tâche, vous souhaiterez peut-être vérifier que vous disposez de vos informations d’identification AWS.

use role dl_customer;
use database cxone_export;
use schema export_data;

create stage s3_unload_stage
storage_integration = dl_s3_integration
url = 's3://destination-bucket/';

-- 2. Export agent dim
// SP and Task to unload agent DIM
create or replace procedure unload_agent_dim_sp()
returns string not null
language javascript
as
$$
var sql_command = "";
var curDate = new Date().toISOString();
var sql_command = sql_command.concat("copy into @s3_unload_stage","/agent_dim/", curDate,"/"," from cxone_shared.acd.agent_dim_view overwrite=true;");
var statement = snowflake.createStatement( {sqlText: sql_command} );
var result_set = statement.execute();
return sql_command; // Statement returned for info/debug purposes
$$;
create task unload_agent_dim_task
warehouse = dl_export
schedule = 'using cron */5 * * * * UTC'
as
call unload_agent_dim_sp();

alter task unload_agent_dim_task resume;
 
alter task unload_agent_dim_task suspend;
 
-- 3. Export Contact Type Dim
// SP and task to unload agent DIM
create or replace procedure unload_contact_type_dim_sp()
returns string not null
language javascript
as
$$
var sql_command = "";
var curDate = new Date().toISOString();
var sql_command = sql_command.concat("copy into @s3_unload_stage","/contact_type_dim/", curDate,"/"," from cxone_shared.acd.contact_type_dim_view overwrite=true header=true;");
var statement = snowflake.createStatement( {sqlText: sql_command} );
var result_set = statement.execute();
return sql_command;
$$;
create task unload_contact_type_dim_task
warehouse = dl_export
schedule = 'using cron */5 * * * * UTC'
as
call unload_contact_type_dim_sp();
 
alter task unload_contact_type_dim_task suspend;
 
 
 
// 'watching unload tasks status'
show tasks;
select *
from table(information_schema.task_history())
order by scheduled_time DESC;
Nom de la ressource Nom Détails
Rôle DL_CUSTOMER Rôle utilisé pour exécuter les requêtes SQL. Ce rôle doit disposer des autorisations nécessaires pour créer STAGE, PROCEDUREet TASK.

Base de données partagée

 CXONE_SHARED

Tous les objets seront partagés avec cette base de données. Les utilisateurs peuvent lire des données à partir des vues partagées de cette base de données.
Base de données d’exportation CXONE_EXPORT Vous pouvez créer de nouvelles ressources sous cette base de données.
Schéma d’exportation EXPORT_DATA Le schéma sous la base de données CXONE_EXPORT. Toutes les nouvelles ressources vont à l’intérieur de ce schéma.
Intégration de stockage DL_S3_INTEGRATION Activer l'exportation des données vers un AWS bucket S3. Ensuite, vous pouvez créer la zone de préparation à l’aide de l’intégration de stockage.
Entrepôt DL_EXPORT Le nom de l'entrepôt qui exécute toutes les requêtes SQL.

  1. Cliquez sur le sélecteur d'applications icône du sélecteur d'applications et sélectionnez Admin.

  2. Accédez à Configuration du compte > Data Share.

  3. Dans la section Intégration de stockage - AWS Compte, saisissez vos AWSinformations pour le chemin S3 et le rôle IAM.

    Champ Détails
    Chemin S3 L'URL de votre bucket S3 AWS.

    Rôle IAM

    Un rôle IAM avec accès en écriture à votre bucket S3 AWS. Pour plus d'informations sur la configuration d'un rôle IAM, consultez la SnowflakedocumentationCe lien s'ouvre dans un nouvel onglet de navigateur.

  4. Cliquez sur Enregistrer.

  5. Créez une étape dans Snowflake. Mettez à jour votre rôle avec votre utilisateur IAM AWSet votre ID externe comme décrit dans la documentation Snowflake Ce lien s'ouvre dans un nouvel onglet de navigateur. Le nom de l’intégration du stockage est dl_s3_integration. Par exemple :

    create stage __STAGE_NAME__
storage_integration = dl_s3_integration
url = '__S3_PATH__';

  6. Créez la procédure de stockage. Consultez la documentation Snowflake pour obtenir de l'aide sur la création de la procédure de stockage Ce lien s'ouvre dans un nouvel onglet de navigateur et création de l'instruction SQL de copie dans l'étape pour la procédure de stockage Ce lien s'ouvre dans un nouvel onglet de navigateur. Par exemple :

    create or replace procedure __STORE_PROCEDURE_NAME__()
returns string not null
language javascript
as
$$
var sql_command = "";
var curDate = new Date().toISOString();
var sql_command = sql_command.concat("copy into @__STAGE_NAME__","/path/", curDate,"/"," from cxone_shared.__SCHEMA__.__VIEW_NAME__overwrite=true header=true;");
var statement = snowflake.createStatement( {sqlText: sql_command} );
var result_set = statement.execute();
return sql_command;
$$;

  7. Créez une tâche. Consultez la documentation Snowflake pour en savoir plus sur les tâches Ce lien s'ouvre dans un nouvel onglet de navigateur et pour obtenir de l'aide sur la création de la tâche Ce lien s'ouvre dans un nouvel onglet de navigateur.

    create task __TASK_NAME__
warehouse = dl_export
schedule = 'using cron */30 * * * * UTC'    -- Give any required cron expression. For example we have given cron for every 30 mins
as
call __STORE_PROCEDURE_NAME__();
   
alter task __TASK_NAME__ resume;

Accès aux données CXone Mpower

  1. Ouvrez votre interface Web Snowflake.
  2. Accédez à Data Products > Private Sharing. Vous devriez voir un partage CXone Mpower.
  3. Affichez et interrogez les objets de la base de données partagée CXone Mpower comme vous le feriez avec n'importe quelle autre base de données de votre compte. Vous devriez voir tous les partages disponibles dans votre compte. La colonne Base de données affiche le nom de la base de données créée à partir du partage. Pour plus d'informations, consultez la Snowflake documentation Ce lien s'ouvre dans un nouvel onglet de navigateur.

Si la création du partage échoue, vous recevez une notification d'échec dans le coin supérieur droit de l'écran. Contactez votre Représentant de compte pour obtenir de l’aide.