Perguntas frequentes

Este documento fornece respostas a perguntas frequentes sobre o Serviço de consulta e fornece uma lista de códigos de erro vistos com frequência ao usar o Serviço de consulta. Para perguntas e soluções de problemas relacionados a outros serviços na Adobe Experience Platform, consulte o guia de solução de problemas do Experience Platform.

A lista de respostas a seguir para perguntas frequentes está dividida nas seguintes categorias:

Perguntas gerais do Serviço de consulta general

Esta seção inclui informações sobre desempenho, limites e processos.

Posso desativar o recurso de preenchimento automático no Editor do serviço de consulta?

+++Número de resposta No momento, o editor não oferece suporte à desativação do recurso de preenchimento automático.
+++

Por que o Editor de consultas às vezes fica lento quando digito uma consulta?

+++Resposta Uma causa potencial é o recurso de preenchimento automático. O recurso processa determinados comandos de metadados que podem retardar ocasionalmente o editor durante a edição de consultas.
+++

Posso usar Postman para a API do Serviço de consulta?

+++Responda Sim, você pode visualizar e interagir com todos os serviços de API do Adobe usando Postman (um aplicativo gratuito de terceiros). Assista ao Postman guia de configuração para obter instruções passo a passo sobre como configurar um projeto no Adobe Developer Console e adquirir todas as credenciais necessárias para uso com o Postman. Consulte a documentação oficial para orientação sobre como iniciar, executar e compartilhar Postman coleções.
+++

Há um limite para o número máximo de linhas retornadas de uma consulta por meio da interface do usuário?

+++Resposta Sim, o Serviço de consulta aplica internamente um limite de 50.000 linhas, a menos que um limite explícito seja especificado externamente. Consulte as orientações sobre execução de consulta interativa para obter mais detalhes.
+++

Posso usar consultas para atualizar linhas?

+++Resposta Em consultas em lote, não há suporte para a atualização de uma linha dentro do conjunto de dados.
+++

Existe um limite de tamanho de dados para a saída resultante de um query?

+++Número de resposta Não há limite de tamanho de dados, mas há um tempo limite de consulta de 10 minutos de uma sessão interativa. Se a consulta for executada como um CTAS em lote, um tempo limite de 10 minutos não será aplicável. Consulte as orientações sobre execução de consulta interativa para obter mais detalhes.
+++

Como ignorar o limite no número de saída de linhas de uma consulta SELECT?

SELECT * FROM customers LIMIT 0;

Como faço para impedir que minhas consultas expirem em 10 minutos?

Há algum problema ou impacto no desempenho do Serviço de consulta se várias consultas forem executadas simultaneamente?

+++Número de resposta O Serviço de consulta tem um recurso de dimensionamento automático que garante que as consultas simultâneas não tenham nenhum impacto observável no desempenho do serviço.
+++

Posso usar palavras-chave reservadas como nome de coluna?

+++Resposta Há determinadas palavras-chave reservadas que não podem ser usadas como nome de coluna, como, ORDER, GROUP BY, WHERE, DISTINCT. Se quiser usar essas palavras-chave, você deve omitir essas colunas.
+++

Como faço para localizar um nome de coluna a partir de um conjunto de dados hierárquico?

Como acelerar um query em um conjunto de dados que contém arrays?

+++Responder Para melhorar o desempenho de consultas em conjuntos de dados que contêm matrizes, você deve explodir a matriz as a consulta CTAS em tempo de execução e depois o explore para obter mais oportunidades de melhorar o tempo de processamento.
+++

Por que minha consulta CTAS ainda está processando depois de muitas horas para apenas um pequeno número de linhas?

Como entrar em contato com o suporte ao cliente do Adobe? customer-support

Como implementar uma série sequencial de jobs sem executar jobs subsequentes se o job anterior não for concluído com sucesso?

Como implementar a atribuição personalizada no Serviço de consulta?

Posso modelar minhas consultas para reutilizá-las facilmente?

+++Resposta Sim, você pode modelar consultas usando instruções preparadas. As instruções preparadas podem otimizar o desempenho e evitar a reanálise repetitiva de uma consulta. Consulte a documentação de instruções preparadas para obter mais detalhes.
+++

Como faço para recuperar logs de erros de uma consulta? error-logs

{
    "isInsertInto": false,
    "request": {
                "dbName": "prod:all",
                "sql": "SELECT *\nFROM\n  accounts\nLIMIT 10\n"
            },
    "clientId": "8c2455819a624534bb665c43c3759877",
    "state": "SUCCESS",
    "rowCount": 0,
    "errors": [{
      'code': '58000',
      'message': 'Batch query execution gets : [failed reason ErrorCode: 58000 Batch query execution gets : [Analysis error encountered. Reason: [sessionId: f055dc73-1fbd-4c9c-8645-efa609da0a7b Function [varchar] not defined.]]]',
      'errorType': 'USER_ERROR'
      }],
    "isCTAS": false,
    "version": 1,
    "id": "343388b0-e0dd-4227-a75b-7fc945ef408a",
}

O que significa "Erro ao validar o esquema"?

CREATE TABLE table_name WITH (SCHEMA='schema_name')

AS SELECT '1' as _id,

 STRUCT

  ('2021-02-17T15:39:29.0Z' AS taskActualCompletionDate,

    '2020-09-09T21:21:16.0Z' AS taskActualStartDate,

    'Consulting' AS taskdescription,

    '5f6527c10011e09b89666c52d9a8c564' AS taskguide,

    'Stakeholder Consulting Engagement' AS taskname,

    '2020-09-09T15:00:00.0Z' AS taskPlannedStartDate,

    '2021-02-15T11:00:00.0Z' AS taskPlannedCompletionDate

  ) AS _workfront ;

Como posso processar rapidamente os novos dados que entram no sistema todos os dias?

+++Responder A SNAPSHOT A cláusula pode ser usada para ler incrementalmente os dados em uma tabela com base em uma ID de snapshot. Isso é ideal para uso com o carga incremental padrão de design que processa apenas as informações no conjunto de dados que foi criado ou modificado desde a última execução de carregamento. Como resultado, aumenta a eficiência do processamento e pode ser usado com processamento de dados em lote e de transmissão.
+++

Por que há uma diferença entre os números mostrados na interface do usuário do perfil e os números calculados do conjunto de dados de exportação de perfil?

Por que minha consulta retornou um subconjunto vazio e o que devo fazer?

SELECT count(1) FROM myTableName

Posso obter amostras dos meus dados?

+++Resposta Este recurso está em andamento no momento. Os detalhes serão disponibilizados em notas de versão e pelas caixas de diálogo da interface do usuário da Platform, quando o recurso estiver pronto para lançamento.
+++

Quais funções auxiliares são compatíveis com o Serviço de consulta?

+++O Serviço de consulta de resposta fornece várias funções auxiliares de SQL incorporadas para estender a funcionalidade SQL. Consulte o documento para obter uma lista completa dos Funções SQL suportadas pelo Serviço de consulta.
+++

São todos nativos Spark SQL há suporte para funções ou os usuários estão restritos apenas ao invólucro Spark SQL funções fornecidas pelo Adobe?

+++Resposta Ainda não, nem todos os arquivos de código aberto Spark SQL As funções do foram testadas nos dados do data lake. Depois de testados e confirmados, eles serão adicionados à lista de itens com suporte. Consulte a lista de suportados Spark SQL funções para verificar se há uma função específica.
+++

Os usuários podem definir suas próprias funções definidas pelo usuário (UDF) que podem ser usadas em outras consultas?

+++Resposta Devido a considerações de segurança de dados, a definição personalizada de UDFs não é permitida.
+++

O que devo fazer se minha consulta programada falhar?

O que significa o erro "Limite de sessão atingido"?

+++Resposta "Limite de Sessão Atingido" significa que o número máximo de sessões do Serviço de Consulta permitido para sua organização foi atingido. Conecte-se com o administrador do Adobe Experience Platform da sua organização.
+++

Como o log de consultas lida com consultas relacionadas a um conjunto de dados excluído?

+++O Serviço de consulta de resposta nunca exclui o histórico de consultas. Isso significa que qualquer consulta que faça referência a um conjunto de dados excluído retornaria "Nenhum conjunto de dados válido" como resultado.
+++

Como posso obter somente os metadados de um query?

SELECT * FROM <table> WHERE 1=0

Como posso iterar rapidamente em uma consulta CTAS (Create Table As Select) sem materializá-la?

CREATE temp TABLE temp_dataset AS
SELECT *
FROM actual_dataset
WHERE 1 = 0;

INSERT INTO temp_dataset
SELECT a._company AS _company,
a._id AS _id,
a.timestamp AS timestamp
FROM actual_dataset a
WHERE timestamp >= TO_TIMESTAMP('2021-01-21 12:00:00')
AND timestamp < TO_TIMESTAMP('2021-01-21 13:00:00')
LIMIT 100;

Como alterar o fuso horário de e para um Carimbo de data e hora UTC?

SELECT to_utc_timestamp('2021-08-31', 'Asia/Seoul');

2021-08-30 15:00:00

8/30/2021, 3:00 PM

SELECT from_utc_timestamp('2021-08-31 14:40:00.0', 'Asia/Seoul');

8/31/2021, 11:40 PM

SELECT a._company  AS _company,
       a._id       AS _id,
       a.timestamp AS timestamp
FROM   dataset a
WHERE  timestamp >= To_timestamp('2021-01-21 12:00:00')
       AND timestamp < To_timestamp('2021-01-21 13:00:00')

Como usar corretamente a variável CAST operador para converter meus carimbos de data e hora em consultas SQL?

SELECT * FROM ABC
WHERE timestamp = CAST('07-29-2021' AS timestamp)

SELECT * FROM ABC
WHERE timestamp = CAST('07-29-2021 00:00:00' AS timestamp)

Devo usar curingas, como *, para obter todas as linhas dos meus conjuntos de dados?

+++Resposta Não é possível usar curingas para obter todos os dados de suas linhas, pois o Serviço de consulta deve ser tratado como um columnar-store em vez de um sistema de armazenamento tradicional baseado em linhas.
+++

Devo usar NOT IN em minha consulta SQL?

CREATE TABLE T1 (ID INT)
CREATE TABLE T2 (ID INT)
INSERT INTO T1 VALUES (1)
INSERT INTO T1 VALUES (2)
INSERT INTO T1 VALUES (3)
INSERT INTO T2 VALUES (1)
INSERT INTO T2 VALUES (2)

SELECT ID FROM T1
WHERE NOT EXISTS
(SELECT ID FROM T2 WHERE T1.ID = T2.ID)

SELECT T1.ID FROM T1
LEFT OUTER JOIN T2 ON T1.ID = T2.ID
WHERE T2.ID IS NULL

Posso criar um conjunto de dados usando uma consulta CTAS com um nome de sublinhado duplo como aqueles exibidos na interface? Por exemplo: test_table_001.

+++Resposta Não, essa é uma limitação intencional no Experience Platform que se aplica a todos os serviços da Adobe, incluindo o Serviço de consulta. Um nome com dois sublinhados é aceitável como um esquema e nome de conjunto de dados, mas o nome da tabela do conjunto de dados só pode conter um único sublinhado.
+++

Quantas consultas simultâneas você pode executar de cada vez?

+++Resposta Não há limite de simultaneidade de consulta, pois as consultas em lote são executadas como trabalhos de back-end. No entanto, há um tempo limite de consulta definido como 24 horas.
+++

Existe um painel de atividades onde você pode ver as atividades de consulta e o status?

+++Resposta Há recursos de monitoramento e alerta para verificar as atividades e os status de consultas. Consulte a Integração do log de auditoria do Serviço de consulta e a variável logs de consulta documentos para obter mais informações.
+++

Há alguma maneira de reverter as atualizações? Por exemplo, se houver um erro ou alguns cálculos precisarem ser reconfigurados ao gravar dados na Platform, como esse cenário deve ser tratado?

+++Responder No momento, não oferecemos suporte a reversões ou atualizações dessa maneira.
+++

Como você pode otimizar consultas no Adobe Experience Platform?

Os logons podem ser restritos a certos aspectos do Serviço de consulta ou é uma solução "tudo ou nada"?

+++O Serviço de consulta de resposta é uma solução "tudo ou nada". O acesso parcial não pode ser fornecido.
+++

Posso restringir quais dados o Serviço de consulta pode usar ou ele simplesmente acessa todo o data lake da Adobe Experience Platform?

+++Resposta Sim, você pode restringir a consulta a conjuntos de dados com acesso somente leitura.
+++

Quais outras opções existem para restringir os dados que o Serviço de consulta pode acessar?

Depois que os dados forem retornados pelo Serviço de consulta, há verificações que podem ser executadas pela Plataforma para garantir que ela não tenha retornado dados protegidos?

Posso especificar um modo SSL para a conexão com um cliente de terceiros? Por exemplo, posso usar "verify-full" com o Power BI?

+++Responda Sim, os modos SSL são compatíveis. Consulte a Documentação de modos SSL para obter uma discriminação dos diferentes modos SSL disponíveis e o nível de proteção que eles fornecem.
+++

Usamos o TLS 1.2 para todas as conexões de clientes Power BI com o serviço de consulta?

+++Responda Sim. Os dados em trânsito são sempre compatíveis com HTTPS. A versão atualmente compatível é TLS1.2.
+++

Uma conexão feita na porta 80 ainda usa https?

+++Responda Sim, uma conexão feita na porta 80 ainda usa SSL. Você também pode usar a porta 5432.
+++

Posso controlar o acesso a conjuntos de dados e colunas específicos para uma conexão específica? Como isso é configurado?

+++Responda Sim, o controle de acesso baseado em atributo é aplicado se configurado. Consulte a visão geral do controle de acesso baseado em atributos para obter mais informações.
+++

O Serviço de consulta suporta o comando "INSERT OVERWRITE INTO"?

+++Resposta Não, o Serviço de Consulta não oferece suporte ao comando "INSERT OVERWRITE INTO".
+++

Com que frequência os dados de uso no painel de uso de licença são atualizados para as horas de computação do Data Distiller?

+++Resposta O painel de uso de licença para horas de computador do Data Distiller é atualizado quatro vezes por dia, a cada seis horas.
+++

Posso usar o comando CREATE VIEW sem acesso ao Data Distiller?

+++Responder Sim, você pode usar CREATE VIEW sem acesso ao Data Distiller. Esse comando fornece uma exibição lógica dos dados, mas não os grava no data lake.
+++

Posso usar blocos anônimos no DbVisualizer?

+++Responda Sim. Embora alguns clientes de terceiros, como DbVisualizer, possam exigir um identificador separado antes e depois de um bloco SQL para indicar que uma parte de um script deve ser tratada como uma única instrução. Mais detalhes podem ser encontrados na documentação de bloqueio anônimo ou em a documentação oficial do DbVisualizer.
+++

Exportar dados exporting-data

Esta seção fornece informações sobre exportação de dados e limites.

Existe uma maneira de extrair dados do Serviço de consulta após o processamento da consulta e salvar os resultados em um arquivo CSV? export-csv

SELECT column1, column2
FROM <table_name>
\g <table_name>.out

Posso extrair o conteúdo do conjunto de dados final que foi assimilado por meio de queries CTAS (supondo que sejam quantidades maiores de dados, como Terabytes)?

+++Número de resposta No momento, não há nenhum recurso disponível para a extração de dados assimilados.
+++

Por que o conector de dados do Analytics não retorna dados?

SELECT * FROM prod_table LIMIT 1;

SELECT * FROM prod_table
WHERE
timestamp >= to_timestamp('2022-07-22')
and timestamp < to_timestamp('2022-07-23');

Ferramentas de terceiros third-party-tools

Esta seção inclui informações sobre o uso de ferramentas de terceiros, como PSQL e Power BI.

Posso conectar o Serviço de consulta a uma ferramenta de terceiros?

+++Resposta Sim, você pode conectar vários clientes de desktop de terceiros ao Serviço de consulta. Consulte a documentação para detalhes completos sobre os clientes disponíveis e como conectá-los ao Serviço de consulta.
+++

Há uma maneira de conectar o Serviço de consulta uma vez para uso contínuo com uma ferramenta de terceiros?

+++Resposta Sim, os clientes de desktop de terceiros podem ser conectados ao Serviço de consulta por meio de uma configuração única de credenciais sem expiração. Credenciais que não expiram podem ser geradas por um usuário autorizado e recebidas em um arquivo JSON baixado automaticamente para a máquina local. Completo orientação sobre como criar e baixar credenciais sem expiração podem ser encontradas na documentação.
+++

Por que minhas credenciais sem expiração não estão funcionando?

Que tipo de editores SQL de terceiros posso conectar ao Editor de serviço de consulta?

+++Responder Qualquer editor SQL de terceiros que seja PSQL ou Postgres compatível com o cliente pode ser conectado ao Editor de Serviço de Consulta. Consulte a documentação para conectar clientes ao Serviço de consulta para obter uma lista de instruções disponíveis.
+++

Posso conectar a ferramenta Power BI ao Serviço de consulta?

+++Resposta Sim, você pode conectar o Power BI ao Serviço de consulta. Consulte a documentação para instruções sobre como conectar o aplicativo de desktop do Power BI ao Serviço de consulta.
+++

Por que os painéis demoram muito para carregar quando conectados ao Serviço de consulta?

É possível acessar o Serviço de consulta usando a ferramenta de conexão pgAdmin?

+++Resposta Não, a conectividade com o pgAdmin não é compatível. A lista de clientes de terceiros disponíveis e instruções sobre como conectá-los ao Serviço de consulta podem ser encontradas na documentação.
+++

Erros de API PostgreSQL postgresql-api-errors

A tabela a seguir fornece códigos de erro PSQL e suas possíveis causas.

Por que recebi um código de erro 58000 ao usar o método history_meta() na tabela?

ErrorCode: 58000 Internal System Error [Invalid table your_table_name. historyMeta can be used on datalake tables only.]

Query complete in {timeframe}. 0 rows returned.

Erros de REST API rest-api-errors

A tabela a seguir fornece códigos de erro HTTP e suas possíveis causas.