Consultar dados com o Lens

Você pode escrever consultas Lens no Query Builder, Notebooks e em dashboards personalizados. Esta página explica como consultar dados em cada plataforma.

Pré-requisitos

Antes de começar:

• Verifique se você tem as permissões necessárias para consultar fontes de dados.
• Se você precisar consultar fontes de dados externas, certifique-se de que os connectors estejam configurados.

Consulta no construtor de consultas

1. Vá para one.newrelic.com.
2. A partir da gaveta na parte inferior da página, abra o console Query your data.
3. No editor de consultas, selecione Lens data (SQL) como a linguagem de consulta.
4. Se você deseja consultar dados do NRDB, selecione a conta no seletor de contas. Outros data connectors estão disponíveis no nível da organização e não exigem seleção de conta.
5. Escreva sua consulta SQL usando o formato de referência de tabela: connection_name.schema.table
6. Clique em Run. O gráfico é renderizado com base nos resultados da sua consulta.

Salvar consulta em Notebooks

Notebooks são documentos compartilháveis que combinam consultas, visualizações e documentação em markdown.

1. Vá para one.newrelic.com.
2. A partir da gaveta na parte inferior da página, abra o console Query your data.
3. Ative a chave ao lado de Notebooks. Na parte inferior da página, o botão + SQL aparece.
4. Clique em + SQL para adicionar um bloco SQL.
5. Se você deseja consultar dados do NRDB, selecione a conta no seletor de contas. Outros data connectors estão disponíveis no nível da organização e não exigem seleção de conta.
6. Escreva sua consulta SQL usando o formato de referência de tabela: connection_name.schema.table
7. Clique em Run. O gráfico é renderizado com base nos resultados da sua consulta.
8. Clique em Save.

Para mais orientações, consulte a documentação do Notebooks.

Consulta em dashboards personalizados

Você pode adicionar gráficos baseados em SQL aos seus dashboards personalizados:

1. Vá para one.newrelic.com > Dashboards.
2. Crie um novo dashboard ou abra um existente.
3. Clique em + Add widget e selecione um tipo de gráfico.
4. No editor de consultas, selecione Lens data (SQL) como a linguagem de consulta.
5. Se você deseja consultar dados do NRDB, selecione a conta no seletor de contas. Outros data connectors estão disponíveis no nível da organização e não exigem seleção de conta.
6. Escreva sua consulta SQL usando o formato de referência de tabela: connection_name.schema.table
7. Clique em Run. O gráfico é renderizado com base nos resultados da sua consulta.
8. Clique em Add to dashboard. Para obter mais orientações, consulte a documentação de dashboards personalizados.

Sintaxe SQL

Lens usa ANSI SQL para consultar fontes de dados, para que você não precise aprender linguagens de consulta específicas de banco de dados.

Formato de referência de tabela

Ao escrever consultas em Lens, referencie as tabelas usando o formato:

connection_name.schema.table

Por exemplo:

• telemetry.Transaction - Consulte a tabela Transaction da telemetria (NRDB) connector
• snowflake.sales.orders - Consulte a tabela de pedidos de um Snowflake connector com o nome "snowflake" no esquema "sales"
• gsheets.default.employees - Consulte um Google Sheets connector chamado "gsheets"

Instruções SQL suportadas

Lens suporta instruções padrão ANSI SQL, incluindo:

• SELECT - Consultar dados de uma ou mais tabelas
• JOIN - Combine dados de várias tabelas (incluindo junções entre bancos de dados)
• WHERE - Filtrar resultados
• GROUP BY - Agregar dados
• ORDER BY - Ordenar resultados
• LIMIT - Restrinja o número de linhas retornadas
• WITH (CTEs) - Defina expressões de tabela comuns para consultas complexas

Dicas de desempenho

• Use filtros antecipadamente: Aplique cláusulas WHERE para reduzir a quantidade de dados processados.
• Limitar resultados: Use LIMIT para restringir as linhas retornadas ao explorar dados.
• Considere materialized views: Para consultas complexas executadas com frequência, crie um materialized view.
• Otimize junções: Ao unir tabelas grandes, filtre os dados antes da junção quando possível.

Diferenças de sintaxe de consulta do NRQL e exemplos

Lens usa ANSI SQL em vez de NRQL. Os exemplos a seguir mostram as principais diferenças e padrões de consulta comuns.

FROM PageViewTiming
SELECT count(*)
FACET enduser.id

SELECT "enduser.id", count(*)
FROM telemetry.PageViewTiming
GROUP BY "enduser.id"

FROM PageViewTiming
SELECT count(*)
SINCE 1 day ago

SELECT count(*)
FROM telemetry.PageViewTiming
WHERE timestamp > current_date - INTERVAL '1' DAY

WITH orders AS (
  SELECT
    to_unixtime(date(date_parse(order_date, '%Y-%m-%d'))) as dt,
    count(*) as orders
  FROM gsheets.default.orders
  GROUP BY 1
)
SELECT *
FROM orders
WHERE dt >= to_unixtime(date('2025-10-19'))
  AND dt <= to_unixtime(date('2025-10-21'))
ORDER BY dt ASC

WITH sf AS (
  SELECT DISTINCT user_id, assigned_success_manager
  FROM demogorgon.default.relibank_opportunity_matrix
)
SELECT
  sf.assigned_success_manager,
  MAX(nrdb.largestContentfulPaint)
FROM telemetry.PageViewTiming nrdb
LEFT JOIN sf ON nrdb."enduser.id" = sf.user_id
WHERE timingName = 'largestContentfulPaint'
  AND nrdb.timestamp > current_date - INTERVAL '1' DAY
GROUP BY sf.assigned_success_manager

SELECT *
FROM mv.weekly_performance_summary
WHERE week_number = 42

SELECT
  mv.store_id,
  mv.total_sales,
  s.store_name,
  s.region
FROM mv.store_sales_mv mv
JOIN snowflake.retail.stores s ON mv.store_id = s.store_id
WHERE mv.total_sales > 10000

Tópicos relacionados