Pesquisa rápida

A pesquisa rápida é a paleta de comandos do editor.
Apresenta os comandos disponíveis no separador em que se encontra. Comece a pesquisa com #, @ ou : para, em vez disso, pesquisar no diagrama e ir para uma tabela, uma coluna ou um comentário ou nota.

Abra-a com Ctrl + K (Windows/Linux) ou ⌘ + K (Mac), ou clique no botão Search da barra de ferramentas.
O mesmo atalho fecha-a, tal como Esc e um clique fora do painel. Abri-la fecha o painel Propriedades da tabela, o criador de temas, o seletor Display Language, a caixa de diálogo Export image e a caixa de diálogo Mapear colunas, o que descarta o que tinha escolhido nela. Não se abre enquanto está a editar uma célula de tabela, uma nota, o nome de um grupo de tabelas ou uma célula do separador Dicionário.

Na barra de ferramentas, o botão logo a seguir ao botão Search é o botão Explorer. Abre ou fecha o explorador, uma árvore do diagrama ancorada à esquerda da tela, com Localizar e substituir no topo.
Abrir a paleta deixa o explorador aberto, e Esc fecha então apenas a paleta. Premir Ctrl + F (Windows/Linux) ou ⌘ + F (Mac) na paleta fecha-a e leva o foco do teclado para o campo Localizar do explorador, abrindo o explorador na respetiva pesquisa se este não estiver visível. Ao contrário da entrada Toggle Explorer, a tecla nunca fecha o explorador a partir da paleta — consulte Abrir e fechar. Enquanto o visualizador de diferenças, a viagem no tempo ou a pré-visualização da disposição automática está aberta, o editor deixa passar a tecla: a paleta mantém-se aberta e a tecla segue para o navegador ou para o host — consulte A barra de localização do navegador.
Um host que incorpora o editor pode associar a pesquisa rápida a outra tecla, que a dica do botão Search passa então a mostrar — consulte Atalhos.

Pesquisar e navegar

Escreva para filtrar a lista. Cada tecla premida volta a pesquisar desde o início toda a lista que tem à frente, pelo que apagar caracteres, ou escrever uma nova palavra por cima de uma que não encontrou nada, faz regressar as entradas correspondentes.
A correspondência é aproximada e abrange tanto o nome de uma entrada como as palavras-chave apresentadas ao seu lado. No submenu Import, por exemplo, sdl encontra GraphQL, dbdiagram encontra DBML e azimutt encontra AML. Uma pequena gralha continua a encontrar a respetiva entrada, tal como tabel encontra New Table e imprt encontra Import, mas uma entrada que apenas se assemelha vagamente ao que escreveu fica de fora: memo apresenta apenas New Memo. Uma entrada cujo nome ou palavras-chave contenham o que escreveu, sem distinguir maiúsculas de minúsculas, é sempre apresentada, e uma que escape à correspondência aproximada surge depois das correspondências aproximadas. O que escreveu é realçado onde quer que uma entrada o contenha, sem distinguir maiúsculas de minúsculas.
Num idioma de apresentação que não seja o inglês, os comandos e as entradas dos submenus também se encontram pelos seus nomes e palavras-chave em inglês, que a lista não mostra, pelo que new table encontra New Table seja qual for o idioma em que é apresentado.
Percorra a lista com ↑ e ↓ — a lista dá a volta em ambas as extremidades — e execute a entrada realçada com Enter. A lista desloca-se para manter a entrada realçada à vista e, num painel de editor baixo, encolhe até ao espaço que há por baixo da caixa de pesquisa, pelo que todas as entradas continuam a poder ser alcançadas e a realçada fica à vista. Um comando que tenha um atalho próprio mostra-o no fim da sua linha: à direita, ou à esquerda num idioma de apresentação da direita para a esquerda. Enquanto um método de introdução ainda está a compor, como a meio de uma sílaba coreana, ↑, ↓ e Enter pertencem-lhe e não movem o realce nem executam nenhuma entrada.

Uma entrada como Database, Import ou Auto Layout abre um submenu: as respetivas entradas substituem a lista e a caixa de pesquisa é limpa. Os submenus de Name View, Database, Bracket, Language, dos dois formatos dos nomes, de Schema SQL: Statements, Schema SQL: Header, Theme e Display Language marcam a escolha atual e abrem-se com o realce sobre ela, pelo que Enter a mantém; os outros submenus abrem-se sem nada realçado.
A filtragem só se aplica à lista que tem à frente, e não há forma de voltar a um nível acima, pelo que, para recomeçar, feche e volte a abrir a paleta. Num submenu, #, @, : e ? são texto simples, e não prefixos.

O que a paleta apresenta

A lista depende do separador em que se encontra. Em todos os separadores, a lista começa pela entrada Tab, que muda para o separador Entity Relationship Diagram, Visualization, Schema SQL, Code Generator, Dictionary ou Settings, omitindo aquele em que já se encontra.

No separador ERD: Name View e até quatro entradas que voltam a derivar os nomes físicos, depois Database, Import, Import and Add e Export, depois New Table, New Memo, New Table Group e Group Selected Tables, os quatro tipos de relação e Auto Layout. As tabelas não são apresentadas aqui; escreva # para ir para uma delas.
A entrada Name View abre Physical Names, Logical Names e Both Names, com a vista em vigor marcada, e uma escolha muda a vista tal como a opção Name View do menu de contexto da tela — consulte Mudar de vista. Só é apresentada no separador ERD, também num editor só de leitura.
As entradas de derivação distinguem-se pelas palavras-chave ao seu lado. A entrada Derive Physical Name Again, com column ao lado, deriva a coluna com o foco. A entrada Derive Physical Names Again surge sob a forma de três entradas: com table, para a tabela em que está o foco, o seu nome e todas as colunas; com selected tables, para as tabelas selecionadas enquanto estiverem selecionadas duas ou mais; e com whole document, para todas as tabelas do diagrama. Cada uma só é apresentada enquanto tiver algo que abranger, e nenhuma num editor só de leitura.
A entrada New Memo fica de fora enquanto Opções de vista → Memos oculta as notas. A entrada New Table Group começa a desenhar um grupo de tabelas na tela, e a entrada Group Selected Tables coloca as tabelas selecionadas num novo grupo e abre o nome do grupo para que o possa escrever. Ambas ficam de fora enquanto Opções de vista → Table Groups oculta os grupos, e Group Selected Tables também precisa de pelo menos uma tabela selecionada. As respetivas linhas mostram as teclas: Alt + G (Windows/Linux) ou ⌥ + G (Mac) para desenhar um grupo e T e depois G para agrupar as tabelas selecionadas.
Estas entradas executam os mesmos comandos que o menu de contexto da tela, exceto onde executam os do menu da tabela: Group Selected Tables executa a sua opção Group selected tables, e as entradas de derivação column, table e selected tables executam a sua opção Derive Physical Name Again ou Derive Physical Names Again, sobre o foco ou a seleção, e não sobre o ponto onde clica com o botão direito. View Option e Diff Viewer existem apenas no menu de contexto. A entrada Export oferece as mesmas opções json, Schema SQL e Image que o menu de contexto, e escrever png ou svg dentro dela encontra Image.
Consulte Importar ou exportar ficheiros para saber o que fazem cada formato, Importar e adicionar e a exportação de imagem, e Funções relacionadas com tabelas para saber o que a escolha da base de dados afeta.

No separador Esquema SQL: de novo Database e Bracket, que define o carácter delimitador colocado à volta dos nomes de tabelas, colunas, restrições e índices no SQL gerado — SingleQuote, DoubleQuote, Backtick ou None, para não delimitar de todo. Depois, Schema SQL: Statements e Schema SQL: Header, que fazem as mesmas escolhas que o painel de opções do separador, mas apresentam apenas as que a base de dados selecionada escreve, e Schema SQL: Options panel, que mostra ou oculta esse painel. Consulte Esquema SQL para saber o que cada escolha escreve.

No separador Gerador de código: Database, Bracket enquanto a linguagem é Doctrine, JPA ou SeaORM, depois Language, Table Name Case, Column Name Case e Code Generator: Options panel, que mostra ou oculta o painel de opções do separador. Consulte Gerador de código para saber o que cada destino produz.

Os separadores Visualização, Dicionário e Definições não têm comandos próprios, apenas a entrada Tab e os comandos abaixo que todos os separadores apresentam.

Perto do fim da lista de cada separador, também num editor só de leitura, está a entrada Toggle Explorer, que mostra o seu atalho, Ctrl + F (Windows/Linux) ou ⌘ + F (Mac). Escrever find, replace, rename, tree, outline ou objects também a encontra.
Executá-la fecha a paleta e faz o mesmo que o atalho faz na tela. Enquanto o botão Explorer da barra de ferramentas aparece premido, ou seja, enquanto o explorador está aberto no separador ERD e não está oculto pelo modo zen, fecha o explorador. Caso contrário, muda para o separador ERD e abre o explorador na respetiva pesquisa, com o cursor de texto no campo Localizar — consulte Abrir e fechar. Fica de fora enquanto o visualizador de diferenças, a viagem no tempo ou a pré-visualização da disposição automática está aberta.

Tema e idioma de apresentação

A seguir à entrada Toggle Explorer, todos os separadores apresentam as entradas Theme e Display Language, também num editor só de leitura. Cada uma só é apresentada onde o editor oferece o respetivo seletor, como mostram os botões Theme e Display Language da barra de ferramentas. A aplicação web, o Google Drive, o VS Code, os IDE da JetBrains e o Obsidian oferecem ambos — consulte Em cada host.

A entrada Theme abre System, Light e Dark, com o aspeto atual marcado. Escolher um deles altera apenas o aspeto e mantém o tom de cinzento e a cor de destaque, tal como os botões Appearance do criador de temas.
A entrada Display Language abre System e depois os 25 idiomas, cada um com o seu próprio nome e pela ordem do seletor, com a opção atual marcada. Aqui, um idioma também se encontra pelo seu nome em inglês ou pelo seu código: german ou de-DE encontra Deutsch, e korean encontra 한국어.
Uma escolha em qualquer uma delas aplica-se de imediato, fecha a paleta e é guardada tal como uma escolha feita no criador de temas ou no seletor Display Language. Se o idioma de apresentação mudar enquanto a paleta está aberta, a lista passa para esse idioma, mantendo o que escreveu e o submenu em que se encontra.

Editores só de leitura

Um editor readonly não lista nenhum comando que alteraria o diagrama, em vez de o listar esbatido.
No separador ERD, mantém Tab, Name View, Database, Export com as suas três entradas, Toggle Explorer, Theme e Display Language. Deixa de fora Import, Import and Add, as entradas de derivação, New Table, New Memo, New Table Group, Group Selected Tables, os quatro tipos de relação e Auto Layout.
Os outros separadores listam o que listam em qualquer editor. Onde quer que sejam listados, Tab, Name View, Database, Bracket, Language e os dois formatos do nome alteram apenas esse ecrã e nunca são guardados — consulte Editores só de leitura em Definições.
Se o editor passar a só de leitura, ou voltar a ser editável, enquanto a paleta está aberta, a lista é desenhada de novo com o que o editor então oferece e pesquisada de novo com o que escreveu. Um submenu cuja entrada desapareceu dá lugar ao nível superior.

Os prefixos #, @ e : pesquisam o diagrama como em qualquer editor, e um salto seleciona o ponto onde chega, como descrito em Pesquisar no diagrama. Num editor só de leitura, é a única forma de selecionar alguma coisa: uma pressão na tela não seleciona nada, e um clique que não se move limpa o que o salto selecionou — consulte Editores só de leitura.

Pesquisar no diagrama

Comece a pesquisa com um prefixo para pesquisar no diagrama em vez de nos comandos: # para tabelas, @ para colunas, : para comentários e notas ou ? para listar os prefixos. Um prefixo funciona a partir de qualquer separador. Só conta como primeiro carácter, sem ter em conta os espaços antes dele. Um espaço a seguir ao prefixo é opcional, pelo que #users e # users são a mesma pesquisa, e também contam os caracteres de largura total ＃, ＠, ： e ？ que um método de introdução japonês ou chinês escreve.
Enquanto o campo de pesquisa está vazio no nível superior, uma linha por baixo dele mostra os quatro prefixos; clique num para o escrever. Enquanto um prefixo está em vigor, o fim do campo de pesquisa indica o respetivo âmbito: Tables, Columns, Comments & memos ou Help. Apague o prefixo para recuperar os comandos.

O prefixo # apresenta as tabelas, cada uma com Table ao lado. Uma linha nomeia a sua tabela como a vista de nomes o faz, como Accounts (users) na vista Both Names, e uma tabela sem nenhum nome a mostrar é apresentada como unnamed. Sem nada a seguir a #, as tabelas são ordenadas pelo nome, nunca pelo nome lógico, em todas as vistas. O texto a seguir a # é comparado de forma aproximada, como acima, com o nome e o nome lógico de cada tabela, seja o que for que a vista mostre, pelo que #accounts apresenta users mesmo na vista Physical Names. As tabelas cujo nome ou nome lógico contém o texto surgem primeiro. Os nomes dos grupos de tabelas e os nomes dos índices não são pesquisados com nenhum prefixo; Localizar e substituir pesquisa ambos.

O prefixo @ apresenta as colunas, cada uma com a respetiva localização ao lado, como users.email · Column. O texto a seguir a @ tem de aparecer no nome ou no nome lógico da coluna, sem distinguir maiúsculas de minúsculas e seja o que for que a vista de nomes mostre; esta correspondência não é aproximada. Cada nome que o contém é uma linha própria: uma correspondência no nome lógico mostra o nome lógico, com users.email · Logical name ao lado, pelo que uma coluna cujo nome e nome lógico contêm ambos o texto é apresentada duas vezes. O texto antes do primeiro . restringe a pesquisa às tabelas cujo nome ou nome lógico o contém: @users.em apresenta as colunas que contêm em nas tabelas cujo nome ou nome lógico contém users, @users. apresenta as colunas dessas tabelas e @.em pesquisa todas as tabelas. O nome lógico da própria tabela não gera nenhuma linha com @; # encontra-o. Sem nada a seguir a @, cada coluna é apresentada uma vez, pelo seu nome.

O prefixo : apresenta comentários de tabelas, comentários de colunas e notas, nunca nomes nem nomes lógicos. Cada linha mostra um excerto do texto em torno da correspondência, com users · Table comment, users.email · Column comment ou Memo ao lado. O texto a seguir a : tem de aparecer no comentário ou na nota, sem distinguir maiúsculas de minúsculas, tal como com @. Sem nada a seguir a :, são apresentados os comentários e as notas que não estão vazios. Enquanto Opções de vista → Memos oculta as notas, : não apresenta nenhuma nota.

Os prefixos @ e : apresentam as suas linhas pela ordem em que o documento as guarda: tabela a tabela, o comentário de cada tabela antes das respetivas colunas, pela ordem das colunas, e as notas no fim. Com @, a linha do nome lógico de uma coluna surge antes da linha do seu nome.
O local indicado ao lado de uma linha @ ou : dá os nomes da tabela e da coluna, nunca os seus nomes lógicos, em todas as vistas.

O prefixo ? apresenta Tables, Columns e Comments & memos, e o texto a seguir a ? filtra-os. Escolher um deles substitui o conteúdo do campo de pesquisa pelo respetivo prefixo e deixa a paleta aberta.

Uma lista com prefixo contém todas as correspondências, sejam quantas forem. Um prefixo cuja pesquisa não encontre nada deixa a lista vazia, sem qualquer mensagem.

Escolher uma tabela, coluna, comentário ou nota fecha a paleta e muda para o separador ERD se estiver noutro separador.
A tela desloca-se até ao elemento, a menos que este já esteja bem visível — consulte Onde termina um salto. Uma tabela fica então selecionada sozinha e é trazida para a frente. A menos que o foco já estivesse nessa tabela, a primeira célula do seu cabeçalho recebe o foco: o seu nome, ou o seu nome lógico nas vistas Logical Names e Both Names.
Uma nota fica selecionada sozinha e é trazida para a frente. No caso de uma coluna ou de um comentário, a respetiva tabela fica selecionada sozinha, é trazida para a frente e recebe o foco na célula que contém o texto. Onde a vista não desenha essa célula, o foco passa para a célula desenhada no seu lugar: um nome lógico encontrado na vista Physical Names leva ao nome, e um nome encontrado na vista Logical Names leva ao nome lógico. Um comentário que uma opção de vista das tabelas oculta leva ao nome ao lado ou, na vista Logical Names, ao nome lógico.
Nenhum salto inicia nem conclui uma relação que esteja a ser desenhada.

Para as opções Match Case, Match Whole Word ou Use Regular Expression, ou para substituir texto, recorra a Localizar e substituir, no topo do explorador.

Quando nenhum comando corresponde

No nível superior, sem prefixo, se nenhum comando apresentado contiver o que escreveu, sem distinguir maiúsculas de minúsculas, surgem três linhas a seguir aos comandos: Search tables for "…", Search columns for "…" e Search comments & memos for "…", cada uma com o respetivo prefixo como ícone. Escolher uma delas escreve esse prefixo antes do seu texto, pelo que users passa a #users, e a paleta mantém-se aberta com esses resultados.
Se a pesquisa não encontrar comando nenhum, aparece No commands match por cima da lista, que passa então a conter apenas as três linhas. Se encontrar apenas comandos que não contêm o texto, estes surgem primeiro: no separador ERD sem nenhuma tabela selecionada, tables apresenta New Table, Database e, onde for oferecida, a entrada New Table Group antes das três linhas. Com uma tabela selecionada, a entrada Group Selected Tables, onde for oferecida, contém tables, pelo que as três linhas não aparecem.
Num submenu, uma pesquisa que não encontre nada deixa a lista vazia, sem qualquer mensagem.

Pesquisar em coreano

Uma pesquisa que contenha hangul também corresponde pelas suas letras, nos comandos, nos submenus e com qualquer prefixo.
Cada etapa por que passa um método de introdução coreano continua a encontrar a linha cujo texto está a escrever, pelo que ㅅ, 사, 상, 사요 e 사용 encontram todos 사용자. Uma pesquisa feita apenas de consoantes iniciais corresponde às consoantes iniciais das sílabas, ignorando os espaços: ㅅㅇㅈ encontra 사용자, e ㅈㅁ encontra 주문 내역. Um grupo consonântico que um método de introdução do Windows compõe a partir de duas iniciais escritas seguidas, como ㅄ, conta como as duas (ㅂㅅ), enquanto uma consoante dupla como ㄲ continua a ser uma só letra. O texto guardado em forma decomposta, como acontece com os nomes de ficheiros do macOS, corresponde como se estivesse composto.
As linhas cujo texto completo corresponde à pesquisa, letra a letra ou inicial a inicial, surgem primeiro, depois as linhas que começam por ela e depois as linhas que a contêm. Com @ e :, as linhas que contêm a pesquisa tal como foi escrita surgem antes de todas estas, pela ordem do documento. O realce abrange sílabas inteiras, pelo que 상 realça 사용 em 사용자.