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'idée 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 vous ne l’avez pas encore fait, contactez votre Représentant de compte pour autoriser Data Share. Dites-leur que vous voulez créer un nouveau compte Snowflake.

  • Décidez si vous voulez configurer une intégration avec un outil de rapport externe. Si vous voulez 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 par 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 aussi à créer un utilisateur de service Snowflake, si vous en avez besoin. Un utilisateur de service vous permet de configurer un accès programmatiqueFermé Exécution d’une action à l’aide d’un code informatique plutôt qu’à l’aide d’un processus manuel ou d’une interface utilisateur. Cela permet d’automatiser les tâches, puisqu’elles sont exécutées par un programme ou un script, plutôt que par un être humain. à vos données avec un applicationexterne, comme un outil de rapport 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’application et sélectionnez Admin.

  2. Aller à Paramètres de 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 attendez.

  5. Vérifiez régulièrement les notifications Icône de cloche blanche sur fond bleu indiquant des notifications dans la barre d’outils en haut de l’écran. Lorsqu’une nouvelle notification apparaît, vérifiez que la création de votre compte a réussi. Si la création de votre compte a échoué, ne réessayez pas. Contactez plutôt l’assistance CXone Mpower.

    Capture d’écran d’une notification de création de compte Snowflake 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 uniquement que les formats des entrées 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 Data Share. Elle contient une plage d’adresses IP vérifiées et le bouton Soumettre est activé.

    1. Sur la page Data Share dans CXone Mpower, faites défiler vers le bas jusqu’à Plage IP.
    2. Dans la zone de texte, saisissez les adresses IP et les plages d’adresses IP que vous souhaitez ajouter à la liste d’adresse IP autorisées (allowlist) dans la notation CIDR. Si vous en ajoutez plusieurs en même temps, 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 voulez 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 certain temps, votre clé privée apparaît. Copiez ceci et sauvegardez-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 entrer lors de la configuration ou de la mise à jour de l'authentification pour votre applicationexterne. Ce sont des 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 apparaît dans une fenêtre contextuelle, cliquez sur Copier le lien.

    3. Collez l’URL dans une nouvelle fenêtre ou un nouvel onglet du navigateur.

    4. Définissez votre mot de passe Snowflake.

  9. Connectez-vous à Snowflake :

    1. À partir de la page Data Share, copiez l’ URL d’accès.

    2. Collez l’URL dans un nouvel onglet ou une nouvelle fenêtre du navigateur.

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

  10. Une fois connecté, cliquez sur CXONE_DATASHARE_\u003cBU_ID\u003e à 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 voulez :

  • Modifier la taille de l’entrepôt.

  • Réinitialisez votre mot de passe pour votre compte principal Snowflake si vous le laissez expirer. L’expiration du mot de passe intervient 90 jours après le dernier changement de mot de passe.

Si vous utilisez Data Share avec un compte NiCESnowflake et que vous ne voulez 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 des adresses IP autorisées pour l’accès aux données

Autorisations requises: Partage de données infonuagique activé

Cette section permet d’ajouter des adresses IP et des plages d’adresses IP à votre liste d’adresses IP autorisées. Cela améliore la sécurité en limitant l'accès aux données Snowflake aux seuls utilisateurs qui se connectent à partir des adresses IP que vous spécifiez.

CXone Mpower ne vérifie pas que vos entrées sont des adresses IP réelles. Il vérifie uniquement que les formats des entrées 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 Data Share. Elle contient une plage d’adresses IP vérifiées et le bouton Soumettre est activé.

  1. Cliquez sur le sélecteur d’applications icône du sélecteur d’application et sélectionnezAdmin.

  2. Aller à Paramètres de compte > Data Share.

  3. Sur la page Data Share dans CXone Mpower, faites défiler vers le bas jusqu’à Plage IP.
  4. Dans la zone de texte, saisissez les adresses IP et les plages d’adresses IP que vous souhaitez ajouter à la liste d’adresse IP autorisées (allowlist) dans la notation CIDR. Si vous en ajoutez plusieurs en même temps, 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 des données de Data Share vers votre propre stockage. Cela vous permet de copier CXone Mpower les données de votre compte NiCE Snowflake vers votre propre compartiment S3 AWS. À partir de là, vous pouvez télécharger les données dans votre propre entrepôt de données ou outil de BI.

Avant d’effectuer cette tâche, vous voudrez peut-être vérifier que vous avez 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 Le rôle assumé lors de l’exécution de requêtes SQL. Ce rôle doit avoir les 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 les données des vues partagées de cette base de données.
Exporter la base de données CXONE_EXPORT Vous pouvez créer de nouvelles ressources dans cette base de données.
Exporter le schéma EXPORT_DATA Le schéma de la base de données CXONE_EXPORT. Toutes les nouvelles ressources sont intégrées dans ce schéma.
Intégration du stockage DL_S3_INTEGRATION Activer l'exportation des données vers un bucket S3 AWS. Une fois l’option activée, vous pouvez créer l’étape à l’aide de cette 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’application et sélectionnezAdmin.

  2. Aller à Paramètres de compte > Data Share.

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

    Champ Détails
    S3 Path L'URL de votre compartiment S3 AWS.

    IAM Role

    Un rôle IAM avec accès en écriture à votre compartiment 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 identifiant externe tel que décrit dans la documentation Snowflake Ce lien s'ouvre dans un nouvel onglet de navigateur. Le nom de l’intégration de 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éder aux données CXone Mpower

  1. Ouvrez votre interface Web Snowflake.
  2. Accédez à Produits de données > Partage privé. 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 sur 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 documentation Snowflake 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.