Agendamento de dados no data lake analítico do Amazon Connect - Amazon Connect

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Agendamento de dados no data lake analítico do Amazon Connect

Este tópico detalha o conteúdo das tabelas de agendamento de data lake analítico do Amazon Connect. As tabelas listam a coluna, o tipo e a descrição do conteúdo.

Há duas maneiras de acessar o data lake de análise e configurar os dados a serem compartilhados:

Se você não conseguir acessar as tabelas de agendamento usando a Opção 1, tente usar a Opção 2.

Perfil de agendamento de pessoal

Nome da tabela: staff_scheduling_profile

Chave primária composta: {instance_id, agent_arn, staff_scheduling_profile_version}

Coluna Tipo Descrição
instance_id string O ID da instância do Amazon Connect.
agent_arn string O ARN do agente.
staff_scheduling_profile_version bigint A versão do perfil de agendamento de funcionários.
instance_arn string O ARN da instância do Amazon Connect.
staffing_group_arn string O ARN do Grupo de Pessoal ao qual o Agente está designado.
start_timestamp Timestamp StartTimestamp para o Agente configurado nas Regras da Equipe (os horários são gerados somente após esse timestamp).
end_timestamp Timestamp EndTimestamp para o Agente configurado nas Regras da Equipe (os horários não são gerados além desse carimbo de data/hora).
shift_profile_arn string ARN do perfil de turno ao qual o agente está atribuído, configurado nas Regras da Equipe.
timezone string Fuso horário configurado para o agente.
is_deleted Booleano Defina como Verdadeiro se o Agente for excluído. Caso contrário, defina como False.
last_updated_timestamp Timestamp Registro de data e hora em que o perfil de agendamento da equipe estava. created/updated/deleted
data_lake_last_processed_timestamp Timestamp Timestamp, que mostra a última vez em que o registro foi tocado pelo data lake. Isso pode incluir transformação e preenchimento. Esse campo não pode ser usado para determinar de forma confiável a atualização dos dados.

Atividades por turnos

Nome da tabela: shift_activities

Chave primária composta: {instance_id, shift_activity_arn, shift_activity_version}

Coluna Tipo Descrição
instance_id string O ID da instância do Amazon Connect.
shift_activity_arn string O ARN da atividade de turno.
shift_activity_version bigint A versão Shift Activity.
instance_arn string O ARN da instância do Amazon Connect.
shift_activity_name string Nome da atividade do turno.
type string Tipo de atividade de turno. Os valores possíveis são: PRODUCTIVE, NON_PRODUCTIVE e LEAVE.
sub_type string O subtipo da atividade de turno. Isso só é válido para atividades do tipo NON_PRODUCTIVE. Os valores possíveis são: BREAK_OR_MEAL e NONE.
é rastreada a adesão Booleano Defina como Verdadeiro se a atividade de turno estiver configurada para rastreamento de adesão. Caso contrário, defina como False.
é_pago Booleano Defina como Verdadeiro se a atividade de turno estiver configurada como paga. Caso contrário, defina como False.
is_deleted Booleano Defina como Verdadeiro se a atividade do turno for excluída. Caso contrário, defina como False.
last_updated_timestamp Timestamp O carimbo de data/hora em que ocorreu a atividade do turno. created/updated/deleted
data_lake_last_processed_timestamp Timestamp O timestamp, que mostra a última vez em que o registro foi tocado pelo data lake. Isso pode incluir transformação e preenchimento. Esse campo não pode ser usado para determinar de forma confiável a atualização dos dados.

Perfis de turno

Nome da tabela: shift_profiles

Chave primária composta: {instance_id, shift_profile_arn, shift_profile_version}

Coluna Tipo Descrição
instance_id string O ID da instância do Amazon Connect.
shift_profile_arn string O ARN do perfil de turno.
shift_profile_version bigint A versão Shift Profile.
instance_arn string O ARN da instância do Amazon Connect.
shift_profile_name string O nome do Shift Profile.
is_deleted Booleano Defina como True se o perfil Shift for excluído. Caso contrário, defina como False.
last_updated_timestamp Timestamp O carimbo de data/hora em que estava o perfil de turno. created/updated/deleted
data_lake_last_processed_timestamp Timestamp O timestamp, que mostra a última vez em que o registro foi tocado pelo data lake. Isso pode incluir transformação e preenchimento. Esse campo não pode ser usado para determinar de forma confiável a atualização dos dados.

Grupos de pessoal

Nome da tabela: staffing_groups

Chave primária composta: {instance_id, staffing_group_arn, staffing_group_version}

Coluna Tipo Descrição
instance_id string O ID da instância do Amazon Connect.
staffing_group_arn string O ARN do Staffing Group.
versão_do_grupo_equipe bigint A versão do Staffing Group.
instance_arn string O ARN da instância do Amazon Connect.
nome_do_grupo_do_pessoal string O nome do Staffing Group.
is_deleted Booleano Defina como Verdadeiro se o Grupo de Pessoal for excluído. Caso contrário, defina como False.
last_updated_timestamp Timestamp O carimbo de data/hora em que o Grupo de Pessoal estava. created/updated/deleted
data_lake_last_processed_timestamp Timestamp O timestamp, que mostra a última vez em que o registro foi tocado pelo data lake. Isso pode incluir transformação e preenchimento. Esse campo não pode ser usado para determinar de forma confiável a atualização dos dados.

Grupos de pessoal - Forecast groups

Nome da tabela: staffing_group_forecast_groups

Chave primária composta: {instance_id, staffing_group_arn, staffing_group_version, forecast_group_arn}

Essa tabela deve ser consultada juntando-se à staffing_groups tabela em staffing_group_arn e. staffing_group_version

Coluna Tipo Descrição
instance_id string O ID da instância do Amazon Connect.
staffing_group_arn string O ARN do Staffing Group.
versão_do_grupo_equipe bigint A versão do Staffing Group.
forecast_group_arn string O ARN do Forecast Group associado ao Staffing Group.
instance_arn string O ARN da instância do Amazon Connect.
is_deleted Booleano Defina como False quando a ForecastGroup associação StaffingGroup - for válida.
last_updated_timestamp Timestamp A data e hora em que o Grupo de Pessoal foi criado/atualizado.
data_lake_last_processed_timestamp Timestamp O timestamp, que mostra a última vez em que o registro foi tocado pelo data lake. Isso pode incluir transformação e preenchimento. Esse campo não pode ser usado para determinar de forma confiável a atualização dos dados.

Grupos de pessoal - Supervisores

Nome da tabela: staffing_group_supervisors

Chave primária composta: {instance_id, staffing_group_arn, staffing_group_version, supervisor_arn}

Essa tabela deve ser consultada juntando-se à staffing_groups tabela em staffing_group_arn e. staffing_group_version

Coluna Tipo Descrição
instance_id string O ID da instância do Amazon Connect.
staffing_group_arn string O ARN do Staffing Group.
versão_do_grupo_equipe bigint A versão do Staffing Group.
supervisor_arn string O ARN do agente do supervisor associado ao Grupo de Pessoal.
instance_arn string O ARN da instância do Amazon Connect.
is_deleted Booleano Defina como False quando a ForecastGroup associação StaffingGroup - for válida.
last_updated_timestamp Timestamp A data e hora em que o Grupo de Pessoal foi criado/atualizado.
data_lake_last_processed_timestamp Timestamp O timestamp, que mostra a última vez em que o registro foi tocado pelo data lake. Isso pode incluir transformação e preenchimento. Esse campo não pode ser usado para determinar de forma confiável a atualização dos dados.

Turnos de equipe

Nome da tabela: staff_shifts

Chave primária composta: {instance_id, shift_id, shift_version}

Coluna Tipo Descrição
instance_id string O ID da instância do Amazon Connect.
shift_id string O ID do turno.
versão_de_turno bigint A versão Shift.
instance_arn string O ARN da instância do Amazon Connect.
agent_arn string O ARN do agente.
shift_start_timestamp Timestamp O timestamp de quando o turno começa.
shift_end_timestamp Timestamp O carimbo de data e hora em que o turno termina.
carimbo de data/hora criado Timestamp O carimbo de data e hora em que o turno foi criado.
is_deleted Booleano Defina como Verdadeiro se o Shift for excluído. Caso contrário, defina como False.
last_updated_timestamp Timestamp O carimbo de data/hora em que ocorreu o turno. created/updated/deleted
data_lake_last_processed_timestamp Timestamp O timestamp, que mostra a última vez em que o registro foi tocado pelo data lake. Isso pode incluir transformação e preenchimento. Esse campo não pode ser usado para determinar de forma confiável a atualização dos dados.

Atividades de turnos de funcionários

Nome da tabela: staff_shift_activities

Chave primária composta: {instance_id, shift_id, shift_version, activity_id}

Essa tabela deve ser consultada juntando-se à staff_shifts tabela em shift_id e. shift_version

Coluna Tipo Descrição
instance_id string O ID da instância do Amazon Connect.
shift_id string O ID do turno.
versão_de_turno bigint A versão Shift.
id_de_atividade string O ID da atividade.
instance_arn string O ARN da instância do Amazon Connect.
activity_start_timestamp Timestamp O carimbo de data e hora em que a atividade começa.
activity_end_timestamp Timestamp O carimbo de data e hora em que a atividade termina.
shift_activity_arn string O ARN da atividade de turno. Se o shift_activity_arn for nulo, isso indica a atividade “Trabalho”.
status da atividade string Status da atividade. Isso é definido como INATIVO se a atividade se sobrepor a um tempo livre.
é_horas extras Booleano Defina como Verdadeiro se a atividade fizer parte das horas extras. Caso contrário, defina como False.
is_deleted Booleano Defina como False quando as atividades do turno forem válidas.
last_updated_timestamp Timestamp O carimbo de data e hora em que o Shift foi criado/atualizado.
data_lake_last_processed_timestamp Timestamp O timestamp, que mostra a última vez em que o registro foi tocado pelo data lake. Isso pode incluir transformação e preenchimento. Esse campo não pode ser usado para determinar de forma confiável a atualização dos dados.

Folgas da equipe

Nome da tabela: staff_timeoffs

Chave primária composta: {instance_id, timeoff_id, agent_arn, timeoff_version}

Coluna Tipo Descrição
instance_id string O ID da instância do Amazon Connect.
timeoff_id string O ID da folga.
agent_arn string O ARN do agente.
versão_tempo livre bigint A versão Time Off.
instance_arn string O ARN da instância do Amazon Connect.
tipo_de_tempo livre string Tipo de folga. Os valores possíveis são: TIME_OFF e VOLUNTARY_TIME_OFF.
timeoff_start_timestamp Timestamp Registro de data e hora quando o horário de folga começa.
timeoff_end_timestamp Timestamp Registro de data e hora de término do período de folga.
status de tempo livre string Status da folga. Os valores possíveis são: PENDING_CREATE, PENDING_UPDATE, PENDING_CANCEL, PENDING_ACCEPT, PENDING_APPROVE, PENDING_DECLINE, APPROVED, ACCEPTED, REJEITED, CANCELLED, WAITING_ACCEPT e WAITING_APPROVE. Os status WAITING indicam que o tempo livre está aguardando a ação do usuário. Os status PENDENTE indicam que o intervalo está aguardando o processamento de uma ação do usuário pelo sistema.
shift_activity_arn string O ARN da atividade de turno usada para o tempo livre.
horas de folga efetivas double Total de horas de folga efetivas. As horas de folga efetivas são calculadas com base na lógica de dedução de folga. Isso só é definido para o tipo TIME_OFF.
last_updated_timestamp Timestamp Registro de data e hora em que foi a folga. created/updated/deleted
data_lake_last_processed_timestamp Timestamp Timestamp, que mostra a última vez em que o registro foi tocado pelo data lake. Isso pode incluir transformação e preenchimento. Esse campo não pode ser usado para determinar de forma confiável a atualização dos dados.

Intervalos de folga da equipe

Nome da tabela: staff_timeoff_intervals

Chave primária composta: {instance_id, timeoff_id, timeoff_version, interval_id}

Essa tabela deve ser consultada juntando-se à staff_timeoffs tabela em timeoff_id e. timeoff_version

Coluna Tipo Descrição
instance_id string O ID da instância do Amazon Connect.
timeoff_id string O ID da folga.
versão_tempo livre bigint A versão Time Off.
id_intervalo string O ID do intervalo de folga.
instance_arn string O ARN da instância do Amazon Connect.
timeoff_interval_start_timestamp Timestamp Registro de data e hora quando o intervalo específico de folga começa.
timeoff_interval_end_timestamp Timestamp Registro de data e hora quando o intervalo específico de folga termina.
intervalo_efetivo_timeoff_hours double Horas de folga efetivas para esse intervalo específico de folga. As horas de folga efetivas são calculadas com base na lógica de dedução de folga.
last_updated_timestamp Timestamp Registro de data e hora em que foi a folga. created/updated/deleted
data_lake_last_processed_timestamp Timestamp Timestamp, que mostra a última vez em que o registro foi tocado pelo data lake. Isso pode incluir transformação e preenchimento. Esse campo não pode ser usado para determinar de forma confiável a atualização dos dados.

Esquema de dados

Veja a seguir um diagrama de relacionamento entre entidades que mostra a estrutura e as relações entre as tabelas de agendamento no data lake analítico do Amazon Connect. O diagrama ilustra o esquema do banco de dados com 10 tabelas interconectadas: staff_shift_ activitiesstaff_shifts,staff_timeoffs,,staff_timeoff_intervals,users,routing_profiles,shift_activities,staffing_groups, shift_profiles staffing_group_supervisorsstaffing_group_forecast_groups, e f. orecast_groups

Cada tabela exibe suas chaves e atributos primários com seus tipos de dados. O diagrama ilustra como essas tabelas se relacionam entre si por meio de relacionamentos de chave estrangeira, fornecendo uma visão abrangente do modelo de dados de agendamento.

Um diagrama de relacionamento de entidades que mostra a estrutura e os relacionamentos entre as tabelas de agendamento no data lake analítico do Amazon Connect.

Consultas de exemplo

1. Consulta para obter todas as atividades de turno programadas dos agentes que trabalham em um grupo de previsão específico

SELECT * FROM agent_scheduled_shift_activities_view where forecast_group_name = 'AnyDepartmentForecastGroup'

Conclua as etapas a seguir para criar agent_scheduled_shift_activities_view mencionadas acima.

Etapa 1: criar uma visualização para obter os nomes dos supervisores

CREATE OR REPLACE VIEW "latest_supervisor_names_view" AS SELECT   staffing_group_arn , array_agg(supervisor_name ORDER BY supervisor_name ASC) supervisor_names FROM   (    SELECT      s.staffing_group_arn    , CONCAT(u.first_name, ' ', u.last_name) supervisor_name    FROM      ((       SELECT         staffing_group_arn       , supervisor_arn       FROM         (          SELECT            *          , RANK() OVER (PARTITION BY staffing_group_arn ORDER BY staffing_group_version DESC) recency          FROM            staffing_group_supervisors          WHERE (instance_id = 'YourAmazonConnectInstanceId')       )  t       WHERE (recency = 1)    )  s    INNER JOIN USERS u ON (s.supervisor_arn = u.user_arn)) ) GROUP BY staffing_group_arn

Etapa 2: criar uma visualização para associar o grupo de funcionários e o grupo de previsão a um agente

CREATE OR REPLACE VIEW "latest_agent_staffing_group_forecast_group_view" AS WITH   latest_staff_scheduling_profile AS (    SELECT      agent_arn    , staffing_group_arn    , last_updated_timestamp    FROM      (       SELECT         *       , RANK() OVER (PARTITION BY agent_arn ORDER BY staff_scheduling_profile_version DESC) recency       FROM         staff_scheduling_profile       WHERE ((instance_id = 'YourAmazonConnectInstanceId') AND (is_deleted = false))    )  t    WHERE (recency = 1) ) , latest_staffing_groups AS (    SELECT      staffing_group_name    , staffing_group_arn    FROM      (       SELECT         *       , RANK() OVER (PARTITION BY staffing_group_arn ORDER BY staffing_group_version DESC) recency       FROM         staffing_groups       WHERE (instance_id = 'YourAmazonConnectInstanceId')    )  t    WHERE (recency = 1) ) , latest_forecast_groups AS (    SELECT      forecast_group_arn    , forecast_group_name    FROM      (       SELECT         *       , RANK() OVER (PARTITION BY forecast_group_arn ORDER BY forecast_group_version DESC) recency       FROM         forecast_groups       WHERE (instance_id = 'YourAmazonConnectInstanceId')    )  t    WHERE (recency = 1) ) , latest_staffing_group_forecast_groups AS (    SELECT      staffing_group_arn    , forecast_group_arn    FROM      (       SELECT         *       , RANK() OVER (PARTITION BY staffing_group_arn ORDER BY staffing_group_version DESC) recency       FROM         staffing_group_forecast_groups       WHERE (instance_id = 'YourAmazonConnectInstanceId')    )  t    WHERE (recency = 1) ) SELECT   ssp.agent_arn , U.agent_username AS username , U.agent_routing_profile_id AS routing_profile_id , CONCAT(u.first_name, ' ', u.last_name) agent_name , fg.forecast_group_arn , fg.forecast_group_name , sg.staffing_group_arn , sg.staffing_group_name FROM  latest_staff_scheduling_profile ssp INNER JOIN latest_staffing_groups sg ON ssp.staffing_group_arn = sg.staffing_group_arn INNER JOIN latest_staffing_group_forecast_groups sgfg ON ssp.staffing_group_arn = sgfg.staffing_group_arn INNER JOIN latest_forecast_groups fg ON fg.forecast_group_arn = sgfg.forecast_group_arn INNER JOIN USERS u ON ssp.agent_arn = u.user_arn

Etapa 3: obtenha as atividades mais recentes do Shift

CREATE OR REPLACE VIEW "latest_shift_activities_view" AS SELECT   shift_activity_arn , shift_activity_name , shift_activity_version , type , sub_type , is_adherence_tracked , is_paid , last_updated_timestamp FROM   (    SELECT      *    , RANK() OVER (PARTITION BY shift_activity_arn ORDER BY shift_activity_version DESC) recency    FROM      shift_activities    WHERE (instance_id = 'YourAmazonConnectInstanceId') )  t WHERE (recency = 1)

Etapa 4: criar uma visualização para obter as atividades de turno agendadas pelo agente

CREATE OR REPLACE VIEW "agent_scheduled_shift_activities_view" AS WITH   latest_staff_shifts AS (    SELECT      agent_arn    , shift_id    , shift_version    , shift_start_timestamp    , shift_end_timestamp    , created_timestamp    , last_updated_timestamp    , data_lake_last_processed_timestamp    , recency    FROM      (       SELECT         RANK() OVER (PARTITION BY shift_id ORDER BY shift_version DESC) recency       , *       FROM         staff_shifts sa       WHERE (instance_id = 'YourAmazonConnectInstanceId')    )  t    WHERE ((recency = 1) AND (is_deleted = false)) ) SELECT   asgfg.forecast_group_name , array_join(sn.supervisor_names, ',') supervisor_names , s.agent_arn , u.first_name , u.last_name , asgfg.staffing_group_name , ssa.activity_id , (CASE WHEN (ssa.shift_activity_arn IS NULL) THEN COALESCE(sa.shift_activity_name, 'Work') ELSE sa.shift_activity_name END) shift_activity_name , s.shift_start_timestamp , s.shift_end_timestamp , (CASE WHEN (ssa.shift_activity_arn IS NULL) THEN COALESCE(sa.type, 'PRODUCTIVE') ELSE sa.type END) type , (CASE WHEN (ssa.shift_activity_arn IS NULL) THEN COALESCE(sa.is_paid, true) ELSE sa.is_paid END) is_paid , ssa.activity_start_timestamp , ssa.activity_end_timestamp , ssa.last_updated_timestamp , ssa.data_lake_last_processed_timestamp , u.agent_username as username , u.agent_routing_profile_id as routing_profile_id FROM   staff_shift_activities ssa INNER JOIN latest_staff_shifts s ON s.shift_id = ssa.shift_id AND s.shift_version = ssa.shift_version INNER JOIN USERS u ON s.agent_arn = u.user_arn INNER JOIN latest_agent_staffing_group_forecast_group_view asgfg ON s.agent_arn = asgfg.agent_arn LEFT JOIN latest_shift_activities_view sa ON sa.shift_activity_arn = ssa.shift_activity_arn INNER JOIN latest_supervisor_names_view sn ON sn.staffing_group_arn = asgfg.staffing_group_arn WHERE (ssa.is_deleted = false) AND (COALESCE(ssa.activity_status, ' ') <> 'INACTIVE') AND (ssa.instance_id = 'YourAmazonConnectInstanceId')

2. Consulta para obter todas as solicitações de folga dos agentes em um grupo de previsão específico

SELECT * FROM agent_timeoff_report_view where forecast_group_name = 'AnyDepartmentForecastGroup'

Use a consulta a seguir para criar a agent_timeoff_report_view mencionada acima.

CREATE OR REPLACE VIEW "agent_timeoff_report_view" AS WITH latest_staff_timeoffs AS (         SELECT t1.*,             CAST((t1.effective_timeoff_hours * 60) AS INT) total_effective_timeoff_minutes         FROM (                 SELECT RANK() OVER (                         PARTITION BY timeoff_id                         ORDER BY timeoff_version DESC                     ) recency,                     agent_arn,                     timeoff_id,                     shift_activity_arn,                     timeoff_status,                     timeoff_version,                     effective_timeoff_hours,                     timeoff_start_timestamp,                     timeoff_end_timestamp,                     last_updated_timestamp,                     data_lake_last_processed_timestamp                 FROM staff_timeoffs                 WHERE (                         instance_id = 'YourAmazonConnectInstanceId'                     )             ) t1         WHERE (recency = 1)     ) SELECT asgfg.forecast_group_name,     to.agent_arn,     asgfg.agent_name,     asgfg.staffing_group_name,     asgfg.username,     sa.shift_activity_name,     to.timeoff_start_timestamp,     to.timeoff_end_timestamp,     to.timeoff_status,     array_join(sn.supervisor_names, ',') AS supervisor_names,     sa.is_paid,     to.last_updated_timestamp,     to.data_lake_last_processed_timestamp,     u.agent_routing_profile_id AS routing_profile_id,     to.timeoff_id,     to.shift_activity_arn,     to.total_effective_timeoff_minutes FROM latest_staff_timeoffs to     INNER JOIN latest_agent_staffing_group_forecast_group_view asgfg ON asgfg.agent_arn = to.agent_arn     INNER JOIN latest_shift_activities_view sa ON sa.shift_activity_arn = to.shift_activity_arn     INNER JOIN latest_supervisor_names_view sn ON sn.staffing_group_arn = asgfg.staffing_group_arn     INNER JOIN users u ON u.user_arn = to.agent_arn