Criação de ativos de dados usando consultas SQL

Para adicionar uma exibição dinâmica dos dados de uma conexão ao seu projeto, crie uma consulta SQL para selecionar dados específicos.

Alguns recursos não estão disponíveis em todos os planos. Consulte IBM Knowledge Catalog legacy service plans e IBM watsonx.data intelligence plans.

Para adicionar uma exibição dinâmica:

  1. Na página do projeto, clique na guia Assets (Ativos ) e, em seguida, clique em New asset (Novo ativo) > Create a dynamic view of data (Criar uma exibição dinâmica de dados).

  2. Deixe o método de seleção de dados Write an SQL query selecionado.

  3. Digite um nome e, opcionalmente, uma descrição. O número máximo de caracteres permitidos para o nome ou a descrição é de 100 cada. Você também pode adicionar tags para recuperação, conforme necessário.

  4. Selecione um ativo de conexão existente como a origem dos dados. A conexão deve suportar consultas SQL.

  5. Crie sua consulta SQL. Você mesmo pode criar a consulta SQL ou inserir uma consulta de texto simples e convertê-la em SQL usando um dos modelos disponíveis.

    Para trabalhar com consultas de texto simples, o projeto deve ser ativado para consultas de linguagem natural, mas essa é uma operação única. Para obter detalhes, consulte Configurações das ferramentas de inteligência de dados.

    Para obter resultados SQL mais precisos e contextualizados, você pode fornecer contexto adicional aos modelos enviando exemplos de consultas. Para obter mais informações, consulte Fornecendo contexto adicional para conversões de texto para SQL.

    Lembre-se: não é garantido que as consultas geradas sejam idênticas entre uma execução e outra, portanto, você poderá observar variações.

    1. Na área de texto livre da guia SQL, insira sua consulta de texto, selecione um dos modelos disponíveis (Selecione o ícone do modelo) e gere a instrução SQL.

      Dica: O meta-llama/llama-3-3-70b model é melhor em seguir instruções rápidas para converter texto em SQL e, portanto, pode fornecer resultados mais precisos em comparação com Granite os modelos.

      Uma consulta de texto pode ser semelhante a estes exemplos: "Obter todas as transações com tipo de pagamento" ou "Unir condições e pacientes e, em seguida, pegar as primeiras 100 linhas"

      Ao inserir sua consulta de texto, você pode fornecer informações adicionais que servem como prompt personalizado para o modelo. Preceda essas informações adicionais com o aviso de isenção de responsabilidade Note: . Por exemplo:

      Show records in customer_spend where the spending score is less than 50 and age is between 30 and 50.
Note: include the relevant columns and do not include all the columns

      Os ativos do projeto da conexão e do banco de dados selecionados são usados como ativos de referência para converter sua consulta de texto em uma consulta SQL. Por padrão, o modelo de idioma grande seleciona até 40 ativos mais relevantes desses ativos de referência para a tradução. Para selecionar ativos de referência manualmente, clique em Ativos de referência. Não selecione nenhum arquivo CSV carregado localmente. Esses arquivos não são considerados para a geração de consultas SQL.

    2. Copie a instrução SQL gerada para a área SQL. Você ainda pode atualizar a consulta SQL conforme necessário.

    Como alternativa, você pode inserir diretamente sua consulta SQL para selecionar os dados para a exibição dinâmica.

    Exemplo

    SELECT name, address, client_id FROM BANK1.BANK_CLIENTS WHERE account_type='CHECKING' AND online_access='YES'

    Essa consulta cria uma visualização com as colunas que contêm os nomes, endereços e IDs de clientes que têm acesso on-line à sua conta corrente. A fonte é a tabela do banco de dados BANK_CLIENTS.

  6. Opcional: se você criar esse ativo para gerar um produto de dados, poderá selecionar um conjunto de parâmetros do seu projeto para criar uma consulta personalizável.

    Se você trabalhar com um conjunto de parâmetros, conecte cada parâmetro a um valor de dados. Todos os nomes de parâmetros na consulta devem corresponder aos nomes correspondentes no conjunto de parâmetros. Para especificar um parâmetro, use esta sintaxe: '#<nome_do_parâmetro>#'.

    Exemplo

    SELECT * FROM PUBLIC.COURSES WHERE PUBLIC.COURSES.SEMESTER='#TERM#' AND PUBLIC.COURSES.COURSE_NAME='#COURSE#'

  7. Opcional: Teste sua consulta para validar o SQL. Caso contrário, sua consulta será validada quando você clicar em Criar. Você deve corrigir todos os erros de SQL antes de criar o ativo.

O ativo é adicionado à página Ativos do projeto. Para diferenciar as visualizações dinâmicas de outros ativos de dados, esses ativos são marcados com o ícone de dados de referência (ativo de dados de referência). Se as pastas estiverem habilitadas no projeto, uma visualização dinâmica é sempre criada na pasta raiz, mas você pode movê-la para qualquer subpasta para organizar suas visualizações dinâmicas.

Próximas etapas