Conectar RStudio ao Serviço de consulta

Este documento aborda as etapas para conectar o RStudio ao Adobe Experience Platform Query Service.

Criar uma conexão Query Service na interface RStudio

Após instalar o RStudio, é necessário instalar o pacote RJDBC. As instruções sobre como conectar um banco de dados por meio da linha de comando podem ser encontradas na documentação oficial de Posts.

Se estiver usando um sistema operacional Mac, você pode selecionar Ferramentas na barra de menus seguido por Instalar Pacotes no menu suspenso. Como alternativa, selecione a guia Packages na interface do RStudio e selecione Install.

Um pop-up é exibido, mostrando a tela Install Packages. Verifique se Repository (CRAN) está selecionado para a seção Install from. O valor de Packages deve ser RJDBC. Verifique se Install dependencies está selecionado. Depois de confirmar que todos os valores estão corretos, selecione Install para instalar os pacotes. Agora que o pacote RJDBC foi instalado, reinicie RStudio para concluir o processo de instalação.

Depois que RStudio for reiniciado, você pode se conectar ao Serviço de Consulta. Selecione o pacote RJDBC no painel Packages e digite o seguinte comando no console:

pgsql <- JDBC("org.postgresql.Driver", "{PATH TO THE POSTGRESQL JDBC JAR}", "`")

Onde {PATH TO THE POSTGRESQL JDBC JAR} representa o caminho para o JAR JDBC PostgreSQL que foi instalado em seu computador.

Agora, você pode criar sua conexão com o Serviço de consulta. Digite o seguinte comando no console:

qsconnection <- dbConnect(pgsql, "jdbc:postgresql://{HOSTNAME}:{PORT}/{DATABASE_NAME}?user={USERNAME}&password={PASSWORD}&sslmode=require")

Para obter mais informações sobre como localizar o nome do banco de dados, o host, a porta e as credenciais de logon, leia o guia de credenciais. Para encontrar suas credenciais, faça logon em Platform e selecione Consultas, seguido de Credenciais.

Uma mensagem na saída do console confirma a conexão com o Serviço de consulta.

Gravação de consultas

Agora que você se conectou a Query Service, é possível gravar consultas para executar e editar instruções SQL. Por exemplo, você pode usar dbGetQuery(con, sql) para executar consultas, onde sql é a consulta SQL que você deseja executar.

A consulta a seguir usa um conjunto de dados contendo Eventos de Experiência e cria um histograma de exibições de página de um site, dada a altura da tela do dispositivo.

df_pageviews <- dbGetQuery(con,
"SELECT t.range AS buckets,
 Count(*) AS pageviews
FROM (SELECT CASE
 WHEN device.screenheight BETWEEN 0 AND 99 THEN '0 - 99'
 WHEN device.screenheight BETWEEN 100 AND 199 THEN '100-199'
 WHEN device.screenheight BETWEEN 200 AND 299 THEN '200-299'
 WHEN device.screenheight BETWEEN 300 AND 399 THEN '300-399'
 WHEN device.screenheight BETWEEN 400 AND 499 THEN '400-499'
 WHEN device.screenheight BETWEEN 500 AND 599 THEN '500-599'
 ELSE '600-699'
 end AS range
 FROM aa_post_vals_3) t
GROUP BY t.range
ORDER BY buckets
LIMIT 1000000")

Uma resposta bem-sucedida retorna os resultados da consulta:

df_pageviews
 buckets pageviews
1 0 - 99 198985
2 500-599 67138
3 300-399 2147
4 200-299 354
5 400-499 6947
6 100-199 4415
7 600-699 3097040

Próximas etapas

Para obter mais informações sobre como gravar e executar consultas, leia o manual em executando consultas.