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.
Conteúdo
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_ activities
staff_shifts
,staff_timeoffs
,,staff_timeoff_intervals
,users
,routing_profiles
,shift_activities
,staffing_groups
, shift_profiles
staffing_group_supervisors
staffing_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.

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