Criar e preencher tabelas HubDB

O HubDB é uma ferramenta de banco de dados usada para criar e gerenciar tabelas de dados estruturadas. Você pode usar tabelas do HubDB para criar páginas dinâmicas e tabelas de consulta externamente por meio da API do HubDB. O HubDB armazena dados estruturados (por exemplo, listas de produtos, diretórios de equipes ou programações de eventos) para que as informações possam ser atualizadas em um local central, em vez de atualizar várias páginas individualmente. Saiba mais sobre o HubDB na documentação para desenvolvedores da HubSpot.

Antes de começar

Antes de começar a trabalhar com esse recurso, certifique-se de compreender totalmente quais etapas devem ser executadas com antecedência, bem como as limitações do recurso e as possíveis consequências de usá-lo. 

Compreender limitações e considerações

• Todas as novas tabelas criadas são definidas com um status de rascunho. As tabelas não podem ser usadas para gerar dados com o HubL ou a API até que a tabela seja publicada.
• Revise os limites técnicos do HubDB.

Criar uma tabela

1. Na sua conta da HubSpot, acesse Conteúdo > HubDB.
2. Clique em Criar tabela.
3. Na caixa de diálogo, insira um Etiqueta da tabela e Mesa nome. Não é possível alterar o nome de uma tabela depois de publicá-la.
4. Clique em Criar.

Adicionar ou importar dados da tabela

Depois de criar uma tabela, você pode adicionar novas colunas e linhas para estruturar os dados usados nas páginas do site ou por meio da API do HubDB. Você também pode importar um arquivo CSV para mesclar seus dados em uma tabela do HubDB.

Adicionar colunas de tabela

As colunas definem o tipo de dados armazenados em cada parte da tabela. Ao adicionar uma coluna, você seleciona um tipo de coluna e define as configurações que determinam como os dados são inseridos e usados.

1. Na sua conta da HubSpot, acesse Conteúdo > HubDB.
2. Clique no nome de uma tabela.
3. No canto superior direito, clique no menu suspenso Ações e selecione Adicionar coluna.
4. Na caixa de diálogo, insira um rótulo de coluna.
5. Insira um Nome de coluna. Você pode usar esse nome para consultar seus dados com a API do HubDB.
6. Insira uma Descrição da coluna. Essa descrição aparecerá quando um usuário passar o mouse sobre o info ícone de informações ao lado do nome da coluna.
7. Clique no menu suspenso Tipo de coluna e selecione um tipo de coluna. Alguns tipos de coluna exibirão opções adicionais (por exemplo, Seleção ou Seleção múltipla) para configuração.
8. Quando terminar, clique em Adicionar coluna.

Adicionar linhas da tabela

As linhas armazenam registros individuais na tabela. Adicione linhas para preencher sua tabela com dados estruturados ou atualize as linhas existentes à medida que os dados forem alterados.

1. Na sua conta da HubSpot, acesse Conteúdo > HubDB.
2. Clique no nome de uma tabela.
3. No canto superior direito, clique no menu suspenso Ações e selecione Adicionar linha.
4. Uma nova linha será criada. Se você tiver linhas existentes na tabela, a nova linha será adicionada abaixo das linhas existentes. Insira um valor para cada coluna configurada para a tabela.

Importar dados da tabela com um arquivo CSV

Importe dados de um arquivo CSV para adicionar várias linhas à sua tabela do HubDB de uma só vez. Isso é útil quando você está trabalhando com grandes conjuntos de dados ou migrando informações existentes para o HubDB.

1. Na sua conta da HubSpot, acesse Conteúdo > HubDB.
2. Clique no nome de uma tabela.
3. No canto superior direito, clique no menu suspenso Ações e selecione Importar.
4. Clique no bloco Adicionar ou substituir :
   • Adicionar: linhas da sua planilha serão adicionadas aos dados existentes.
   • Substituir: linhas da sua planilha substituirão todos os dados existentes na sua tabela. Se IDs de linha forem incluídos na planilha, as linhas serão atualizadas em vez de substituídas.
5. Clique em Próximo.
6. Na página Selecionar arquivo , clique em Escolher arquivo.
7. Localize o arquivo CSV no seu sistema de arquivos e clique em Abrir.
8. Por padrão, o HubSpot detectará a codificação dos dados em seu CSV. Para especificar manualmente a codificação de dados:
   • Clique Opções avançadas.
   • Clique no Personalize a codificação de dados menu suspenso e selecione um codificação.
9. Clique em Próximo.
10. Na página Mapear colunas , especifique como você deseja mapear cada campo do seu CSV para a coluna da tabela do HubDB correspondente:
    • Clique no Coluna da tabela HubDB menu suspenso e selecione um coluna.
    • Se você não configurou uma coluna associada para o campo CSV, clique em Adicionar coluna. Na caixa de diálogo, insira um rótulo, um nome e selecione um tipo. Quando terminar, clique em Adicionar coluna.
11. Quando terminar, clique em Importar.
12. Quando a importação for concluída, clique em Feito.

Gerenciar dados da tabela

Gerencie a estrutura e o conteúdo da sua tabela HubDB removendo colunas ou linhas e ajustando sua ordem. Essas ações ajudam a manter a tabela organizada e garantem que os dados sejam estruturados corretamente para uso em seu site ou por meio da API do HubDB.

Remover colunas da tabela

1. Na sua conta da HubSpot, acesse Conteúdo > HubDB.
2. Clique no nome de uma tabela.
3. Passe o cursor do mouse sobre um rótulo de coluna , clique no menu suspenso e selecione Remover.
4. Na caixa de diálogo, clique em Excluir.

Remover linhas da tabela

1. Na sua conta da HubSpot, acesse Conteúdo > HubDB.
2. Clique no nome de uma tabela.
3. Passe o mouse sobre um ID de linha e clique no menu suspenso e, em seguida, selecione Remover.

Reordenar colunas e linhas da tabela

1. Na sua conta da HubSpot, acesse Conteúdo > HubDB.
2. Clique no nome de uma tabela.
3. Para alterar a ordem de uma linha, passe o cursor do mouse sobre o número da linha e clique no dragHandleIcon ícone de arrastar e soltar. Em seguida, mova a linha para cima ou para baixo para uma nova posição.

4. Para alterar a ordem de uma coluna, passe o mouse sobre ela e clique no dragHandleIcon ícone de arrastar e soltar. Em seguida, mova a coluna para a esquerda ou direita para uma nova posição.

Gerenciar configurações da tabela

Gerencie configurações individuais da tabela do HubDB, incluindo opções para acesso público à API e se os dados podem ser usados para criar páginas dinâmicas.

1. Na sua conta da HubSpot, acesse Conteúdo > HubDB.
2. Clique no nome de uma mesa.
3. No canto superior direito, clique no menu suspenso Ações e selecione Gerenciar configurações.
4. No painel direito, ative a opção Permitir acesso à API pública para ativar as chamadas de API não autenticadas para consultar os dados da tabela.
   • Por padrão, os dados da tabela só podem ser acessados no HubSpot por meio do HubL ou de chamadas de API autenticadas.
   • Para consultar os dados, você precisará incluir o ID da conta da HubSpot em um parâmetro de portalId consulta.
5. Para criar páginas dinâmicas usando a tabela, ative a opção Ativar criação de páginas dinâmicas usando dados de linha. Você pode então configurar as seguintes opções adicionais:
   • Na seção Metadados , clique nos menus suspensos e selecione quais colunas preencherão as páginas dinâmicas com dados de metadescrição, imagem em destaque em destaque e URL canônica. Para novas tabelas, você precisará criar novas colunas para conter esses dados.
     • Meta Descrição: deve ser uma coluna de tipo de texto.
     • Imagem em destaque: deve ser uma coluna de tipo de imagem.
     • URL canônico: deve ser uma coluna de tipo de URL.
   • Na seção Tabelas secundárias , marque a caixa de seleção Permitir uso de tabelas secundárias para ativar as referências a outras tabelas do HubDB nesta tabela.
   • Para criar automaticamente páginas de listagem intermediárias, marque a caixa de seleção Criar automaticamente páginas de listagem para tabelas secundárias . Saiba mais sobre como criar páginas dinâmicas multiníveis usando o HubDB .
6. Quando terminar, clique em Salvar.

Observe: uma tabela pai não pode fazer referência a uma tabela filho que também faça referência à tabela pai. Isso criará um loop que resultará em um erro ao tentar selecionar a tabela secundária dentro da tabela principal.

Publicar uma tabela

Publique uma tabela do HubDB para disponibilizar a estrutura e os dados mais recentes para uso em seu site ou por meio da API do HubDB. Depois de criar uma tabela ou fazer atualizações em colunas ou linhas, publique a tabela para que as alterações sejam aplicadas.

1. Na sua conta da HubSpot, acesse Conteúdo > HubDB.
2. Clique no nome de uma tabela.
3. No canto superior direito, clique em Publicar.
4. Na caixa de diálogo, clique em Publicar para aplicar as alterações.

Exportar dados da tabela

1. Na sua conta da HubSpot, acesse Conteúdo > HubDB.
2. Clique no nome de uma tabela.
3. No canto superior direito, clique no menu suspenso Ações e selecione Exportar. Em seguida, selecione uma opção de formato de arquivo (por exemplo, CSV). Os dados da tabela do HubDB começarão a ser baixados imediatamente.

Observe: as imagens exportadas de uma tabela HubDB serão formatadas como URLs de imagem. Caso as dimensões da imagem tenham sido customizadas, elas aparecerão no final da URL.

Ver dependentes da tabela

Antes de atualizar ou excluir uma tabela do HubDB, veja quais ativos dependem dela. A exibição de dependentes de tabela ajuda a entender o efeito das alterações no conteúdo do seu site ou no uso da API.

1. Na sua conta da HubSpot, acesse Conteúdo > HubDB.
2. Clique no menu suspenso Ações e selecione Mostrar dependentes.
3. Na caixa de diálogo, clique em um tipo de ativo (por exemplo, Posts de blog ou Módulos) para expandir a seção e visualizar os ativos individuais.