Configurar o Data Share

Se você ainda não tiver feito isso, entre em contato com seu Representante de contas para ativar o CXone Mpower Data Share. Diga a eles se você tem sua própria conta do Snowflake ou se precisa configurar uma nova conta do CXone Mpower Snowflake.

A configuração do Data Share difere se você tem sua própria conta do Snowflake ou se estiver usando uma conta do CXone Mpower Snowflake. Você faz essa escolha antes da configuração e só pode alterá-la trabalhando com seu Representante de contas.

Os detalhes sobre o esquema de dados estão disponíveis apenas nos artigos compartilhados com você quando você comprou sua licença do Data Share.

Configurar Data Share com uma conta CXone Mpower Snowflake

Siga estas etapas se ainda não tiver sua própria conta do Snowflake. Se optar por usar uma conta do CXone Mpower Snowflake, você deve alterar sua senha a cada 90 dias. Se deixar sua senha expirar, o compartilhamento de dados será interrompido.

Complete cada uma dessas tarefas na ordem indicada.

Crie uma conta CXone Mpower Snowflake

  1. Clique no seletor de aplicativo ícone do seletor de aplicativos e selecione Admin.

  2. Vá para Configurações da conta > Data Share.

  3. Clique em Criar conta.

  4. Na janela de confirmação, selecione Sim, concordo e clique em Confirmar. O processo de criação da conta pode levar até 45 minutos. Você pode continuar a usar CXone Mpower para outras tarefas enquanto espera.

  5. Verifique periodicamente as Notificações Ícone de sino branco em um fundo azul indicando notificações na barra de ferramentas na parte superior da tela. Quando uma nova notificação for exibida, verifique se a criação da sua conta foi bem-sucedida. Se a criação da sua conta falhou, não tente novamente. Em vez disso, entre em contato com o suporte do CXone Mpower.

    Captura de tela de uma notificação de criação de conta do Snowflake no CXone.

  6. Na página Data Share, clique em Gerar novo link para configurar a senha da sua conta do Snowflake. Quando o link aparecer em um pop-up, clique em Copiar URL. Cole o URL em uma nova janela ou guia do navegador. Defina a sua senha do Snowflake.

  7. A partir da página Data Share, adicione os endereços IP e os intervalos de endereços IP aos quais quer conceder acesso aos seus dados Snowflake. Se não adicionar nenhum endereço IP, não será possível acessar o seu URL Snowflake.

    O CXone Mpower não verifica se suas entradas são endereços IP reais. Ele apenas verifica se os formatos de entrada são válidos. Quando um usuário faz login na sua conta do CXone Mpower Snowflake, o CXone Mpower verifica se as tentativas de extrair dados vêm de um dos endereços IP da sua lista de permissões.

    Captura de tela da seção Intervalo de IP da página Compartilhamento de dados. Contém um intervalo de IP verificado e tem o botão Enviar habilitado.
    1. Na página Data Share do CXone Mpower, role para baixo até Intervalo de IP.
    2. Na caixa de texto, digite os endereços IP e os intervalos de endereços IP que você quer adicionar à lista de permissões em notação CIDR. Se você for adicionar mais de um ao mesmo tempo, separe cada entrada com uma vírgula.
    3. Clique em Adicionar.
    4. Depois que o CXone Mpower confirmar que cada endereço IP e intervalo têm um formato válido, clique em Enviar para aplicá-los à sua conta do CXone Mpower Snowflake.

  8. Na página Data Share, copie o URL de acesso. Cole o URL em uma nova guia ou janela do navegador.

  9. Faça login no Snowflake. Use o Nome de usuário do Snowflake do CXone Mpower e a senha que acabou de criar.

  10. Depois de fazer login, clique em CXONE_SHARED à esquerda para começar a navegar pelos objetos de dados compartilhados do CXone Mpower.

Gerenciar a conta do CXone Mpower Snowflake

Ao criar uma conta Snowflake por meio do CXone Mpower, você se tornará dependente do CXone Mpower para algumas das tarefas de manutenção da conta. Você precisará entrar em contato com o seu Representante de contas se quiser:

  • Criar novos usuários em sua conta Snowflake.

  • Alterar o tamanho do depósito.

  • Redefinir sua senha se ela estiver vencida. A senha expira 90 dias após a alteração de senha mais recente.

Se estiver usando o Data Share com uma conta do CXone Mpower Snowflake e não quiser mais essas dependências, peça ajuda ao seu Representante de contas para providenciar seu próprio contrato do Snowflake.

Gerenciar lista de permissões de acesso a dados

Use esta seção para adicionar endereços IP e intervalos de endereços IP à sua lista de permissões. Isso aumentará a segurança, limitando o acesso aos dados do CXone Mpower Snowflake apenas aos usuários que fazem login a partir dos endereços IP que você especificar.

O CXone Mpower não verifica se suas entradas são endereços IP reais. Ele apenas verifica se os formatos de entrada são válidos. Quando um usuário faz login na sua conta do CXone Mpower Snowflake, o CXone Mpower verifica se as tentativas de extrair dados vêm de um dos endereços IP da sua lista de permissões.

Captura de tela da seção Intervalo de IP da página Compartilhamento de dados. Contém um intervalo de IP verificado e tem o botão Enviar habilitado.
  1. Na página Data Share do CXone Mpower, role para baixo até Intervalo de IP.
  2. Na caixa de texto, digite os endereços IP e os intervalos de endereços IP que você quer adicionar à lista de permissões em notação CIDR. Se você for adicionar mais de um ao mesmo tempo, separe cada entrada com uma vírgula.
  3. Clique em Adicionar.
  4. Depois que o CXone Mpower confirmar que cada endereço IP e intervalo têm um formato válido, clique em Enviar para aplicá-los à sua conta do CXone Mpower Snowflake.

Integrar com o armazenamento

Use esta seção se desejar exportar dados do Data Share para seu próprio armazenamento. Isso permite copiar dados do CXone Mpower da sua conta do CXone Mpower Snowflake para o seu próprio repositório AWS S3. A partir daí, você pode baixar os dados para seu próprio depósito de dados ou ferramenta de BI.

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;
Nome do recurso Nome Detalhes
Função DL_CUSTOMER A função assumida ao executar consultas SQL. Esta função deve ter permissões para criar STAGE, PROCEDURE e TASK.

Banco de dados compartilhado

 CXONE_SHARED

Todos os objetos serão compartilhados com este banco de dados. Os usuários podem ler dados das visualizações compartilhadas desse banco de dados.
Exportar banco de dados CXONE_EXPORT Você pode criar novos recursos nesse banco de dados.
Esquema de exportação EXPORT_DATA O esquema no banco de dados CXONE_EXPORT. Todos os novos recursos vão dentro desse esquema.
Integração de armazenamento DL_S3_INTEGRATION Habilita a exportação de dados para um bucket do AWS S3. Depois de habilitado, você poderá criar o estágio usando essa integração de armazenamento.
Depósito DL_EXPORT O nome do depósito que executa todos os SQLs.

  1. Na página Data Share, insira seus detalhes AWS para Caminho S3 e Função IAM.

    campo Detalhes
    Caminho S3 O URL para a sua cesta do AWS S3.

    Função IAM

    Uma função IAM com acesso de gravação à cesta do AWS S3. Para obter informações sobre como configurar uma função do IAM, consulte a documentação do Snowflake.

  2. Clique em Save.

  3. Crie um estágio no Snowflake. Atualize sua função com o usuário e o ID externo do AWS IAM conforme descrito na documentação do Snowflake. O nome da integração de armazenamento é dl_s3_integration.

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

  4. Crie o procedimento de armazenamento. Consulte a documentação do Snowflake para obter ajuda na criação do procedimento de armazenamento e na criação da cópia na instrução SQL de estágio para o procedimento de armazenamento.

    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; $$;

  5. Crie uma tarefa. Consulte a documentação do Snowflake para saber mais sobre as tarefas e ajudar a criar a tarefa.

    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;

Configurar Data Share com sua própria conta Snowflake

Use estas etapas se já tiver sua própria conta do Snowflake. Se optar por usar sua própria conta do Snowflake, ela deverá estar hospedada na AWS e na mesma região do seu ambiente CXone Mpower. O compartilhamento de dados entre regiões ou ambientes de nuvem não é compatível.

Complete cada uma dessas tarefas na ordem indicada.

Conectar sua conta Snowflake

  1. Faça login na sua conta do Snowflake.

  2. Vá até Projetos > Planilhas.

  3. Crie uma planilha SQL, caso ainda não tenha criado uma.

  4. Execute a consulta SQL: select current_account_locator();. Utilize ACCOUNTADMIN como sendo a função. O resultado desta consulta será o localizador de sua conta.

  5. Copie e salve o localizador de conta. Será necessário digitá-lo mais tarde durante esta tarefa.

  6. No CXone Mpower, clique no seletor de aplicativos e selecioneAdmin.

  7. Vá para Configurações da conta > Data Share.

  8. Clique em Criar compartilhamento.

  9. Insira o Localizador de conta associado à sua conta Snowflake.

  10. Clique em Salvar.

Quando sua conta for conectada, um objeto compartilhado será exibido na página Data Share.

Acessar dados do CXone Mpower

  1. Abra a interface da web do Snowflake.
  2. Vá até Produtos de dados > Compartilhamento privado. Você verá um compartilhamento CXone Mpower.

Você deve ver todos os compartilhamentos disponíveis em sua conta. A coluna Banco de dados mostra o nome do banco de dados criado a partir do compartilhamento. Você pode visualizar e consultar os objetos no banco de dados CXone Mpower compartilhado da mesma forma que faria com qualquer outro banco de dados em sua conta.

Se a criação do compartilhamento falhar, você receberá uma notificação de falha no canto superior direito da tela . Entre em contato com o seu Representante de contas para obter assistência.