Pesquisa rápida

A pesquisa rápida é a paleta de comandos do editor.
Ela lista os comandos disponíveis na aba em que você está. Comece a pesquisa com #, @ ou : para pesquisar no diagrama em vez disso 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 em Search na barra de ferramentas.
O mesmo atalho a fecha, assim como Esc e um clique fora do painel. Abri-la fecha o painel Propriedades da tabela, o construtor de temas, o seletor Display Language, a caixa de diálogo Export image e a caixa de diálogo Mapear colunas, que descarta o que você tinha escolhido nela. Ela não abre enquanto você está editando uma célula de tabela, uma nota, o nome de um grupo de tabelas ou uma célula da aba Dicionário.

O botão da barra de ferramentas logo depois de Search é Explorer. Ele abre ou fecha o explorador, uma árvore do diagrama encaixada à esquerda do canvas, com Localizar e substituir no topo.
Abrir a paleta deixa o explorador aberto, e Esc então fecha só a paleta. Ctrl + F (Windows/Linux) ou ⌘ + F (Mac), pressionado na paleta, a fecha e leva o foco do teclado ao campo Localizar do explorador, abrindo o explorador na pesquisa dele se ele não estiver visível. Ao contrário do item 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 do layout automático está aberta, o editor não intercepta a tecla: a paleta continua aberta e a tecla segue para o navegador ou o host — consulte A barra de localização do navegador.
Um host que incorpora o editor pode atribuir a pesquisa rápida a outra tecla, que a dica de ferramenta do botão Search passa a mostrar — consulte Atalhos.

Pesquisar e navegar

Digite para filtrar a lista. Cada tecla digitada pesquisa de novo a lista inteira que está à sua frente, então apagar caracteres, ou digitar uma nova palavra sobre uma que não encontrou nada, traz de volta os itens correspondentes.
A correspondência é aproximada e abrange tanto o nome de um item quanto as palavras-chave mostradas ao lado dele. Dentro do submenu Import, por exemplo, sdl encontra GraphQL, dbdiagram encontra DBML e azimutt encontra AML. Um pequeno erro de digitação ainda encontra o item, como quando tabel encontra New Table e imprt encontra Import, mas um item que só se parece vagamente com o que você digitou fica de fora: memo lista apenas New Memo. Um item cujo nome ou palavras-chave contêm o que você digitou, sem diferenciar maiúsculas de minúsculas, é sempre listado, e um que a correspondência aproximada não encontra vem depois das correspondências aproximadas. O que você digitou é realçado onde quer que um item o contenha, sem diferenciar maiúsculas de minúsculas.
Em um idioma de exibição diferente do inglês, os comandos e os itens de submenu também são encontrados pelos nomes e palavras-chave em inglês, que a lista não mostra, então new table encontra New Table seja qual for o idioma em que ele é mostrado.
Percorra a lista com ↑ e ↓ — ela dá a volta nas duas extremidades — e execute o item realçado com Enter. A lista rola para manter o item realçado à vista e, em um painel de editor baixo, encolhe até o espaço abaixo da caixa de pesquisa, de modo que todo item ainda pode ser alcançado e o realçado continua à vista. Um comando que tem um atalho próprio o mostra no final da linha: à direita, ou à esquerda em um idioma de exibição da direita para a esquerda. Enquanto um método de entrada ainda está compondo, como no meio de uma sílaba coreana, ↑, ↓ e Enter pertencem a ele e não movem o realce nem executam um item.

Um item como Database, Import ou Auto Layout abre um submenu: os itens dele substituem a lista e o campo de pesquisa é limpo. Os submenus de Name View, Database, Bracket, Language, dos dois estilos de nome, de Schema SQL: Statements, Schema SQL: Header, Theme e Display Language marcam a escolha atual e se abrem com o realce nela, então Enter a mantém; os outros submenus se abrem sem nada realçado.
A filtragem sempre se aplica apenas à lista que está à sua frente, e não há como voltar um nível, então feche e reabra a paleta para recomeçar. Dentro de um submenu, #, @, : e ? são texto simples, não prefixos.

O que a paleta lista

A lista depende da aba em que você está. Em toda aba, a lista começa com Tab, que muda para Entity Relationship Diagram, Visualization, Schema SQL, Code Generator, Dictionary ou Settings, deixando de fora a aba em que você já está.

Na aba ERD: Name View e até quatro itens que derivam nomes físicos novamente, depois Database, Import, Import and Add e Export, depois New Table, New Memo, New Table Group e Group Selected Tables, os quatro tipos de relacionamento e Auto Layout. As tabelas não são listadas aqui; digite # para ir para uma delas.
Name View abre Physical Names, Logical Names e Both Names, com a exibição em vigor marcada, e uma escolha troca a exibição como faz o Name View do menu de contexto do canvas — consulte Trocar a exibição. Ele é listado somente na aba ERD, também em um editor somente leitura.
Os itens de derivação se distinguem pelas palavras-chave ao lado deles. Derive Physical Name Again, com column ao lado, deriva a coluna em foco. Derive Physical Names Again aparece como três itens: com table, para a tabela em que está o foco, o nome dela e todas as colunas; com selected tables, para as tabelas selecionadas enquanto duas ou mais estão selecionadas; e com whole document, para todas as tabelas do diagrama. Cada um só é listado enquanto tem algo a abranger, e nenhum em um editor somente leitura.
New Memo fica de fora enquanto View Option → Memos oculta as notas. New Table Group começa a desenhar um grupo de tabelas no canvas, e Group Selected Tables coloca as tabelas selecionadas em um novo grupo e abre o nome dele para digitação. Os dois ficam de fora enquanto View Option → Table Groups oculta os grupos, e Group Selected Tables também exige pelo menos uma tabela selecionada. As linhas deles mostram as teclas: Alt + G (Windows/Linux) ou ⌥ + G (Mac) para desenhar um grupo, e T e depois G para agrupar as tabelas selecionadas.
Esses itens executam os mesmos comandos do menu de contexto do canvas, exceto onde executam os do menu da tabela: Group Selected Tables executa o item Group selected tables dele, e os itens de derivação column, table e selected tables executam o Derive Physical Name Again ou o Derive Physical Names Again dele, sobre o foco ou a seleção, e não sobre o ponto em que você clica com o botão direito. View Option e Diff Viewer estão só no menu de contexto. Export oferece os mesmos json, Schema SQL e Image do menu de contexto, e digitar png ou svg dentro dele encontra Image.
Consulte Importar ou exportar arquivos para saber o que cada formato, Importar e adicionar e a exportação de imagem fazem, e Funções relacionadas a tabelas para saber o que a escolha do banco de dados afeta.

Na aba Esquema SQL: Database de novo e Bracket, que define o caractere delimitador colocado em volta dos nomes de tabelas, colunas, restrições e índices no SQL gerado — SingleQuote, DoubleQuote, Backtick ou None, para não usar delimitador nenhum. Depois, Schema SQL: Statements e Schema SQL: Header, que fazem as mesmas escolhas do painel de opções da aba, mas listam só as que o banco de dados selecionado gera, e Schema SQL: Options panel, que mostra ou oculta esse painel. Consulte Esquema SQL para saber o que cada escolha gera.

Na aba 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 da aba. Consulte Gerador de código para saber o que cada destino produz.

As abas Visualização, Dicionário e Configurações não têm comandos próprios, só Tab e os comandos abaixo, que toda aba lista.

Perto do final da lista de toda aba, também em um editor somente leitura, fica Toggle Explorer, que mostra seu atalho, Ctrl + F (Windows/Linux) ou ⌘ + F (Mac). Digitar find, replace, rename, tree, outline ou objects também o encontra.
Executá-lo fecha a paleta e faz o que o atalho faz no canvas. Enquanto o botão Explorer da barra de ferramentas aparece pressionado, ou seja, enquanto o explorador está aberto na aba ERD e não está oculto pelo modo zen, ele fecha o explorador. Caso contrário, ele muda para a aba ERD e abre o explorador na pesquisa dele, com o cursor de texto no campo Localizar — consulte Abrir e fechar. Ele fica de fora enquanto o visualizador de diferenças, a viagem no tempo ou a pré-visualização do layout automático está aberta.

Tema e idioma de exibição

Depois de Toggle Explorer, toda aba lista Theme e Display Language, também em um editor somente leitura. Cada um só é listado onde o editor oferece o seletor correspondente, como mostram os botões Theme e Display Language da barra de ferramentas. O aplicativo web, o Google Drive, o VS Code, as IDEs da JetBrains e o Obsidian oferecem os dois — consulte Em cada host.

Theme abre System, Light e Dark, com a aparência atual marcada. Escolher um deles muda só a aparência e mantém o tom de cinza e a cor de destaque, como fazem os botões Appearance do construtor de temas.
Display Language abre System e depois os 25 idiomas, cada um com o nome no próprio idioma e na ordem do seletor, com a opção atual marcada. Aqui, um idioma também é encontrado pelo nome em inglês ou pelo código: german ou de-DE encontra Deutsch, e korean encontra 한국어.
Uma escolha em qualquer um dos dois tem efeito imediato, fecha a paleta e é mantida da mesma forma que uma escolha feita no construtor de temas ou no seletor Display Language. Se o idioma de exibição mudar enquanto a paleta está aberta, a lista passa para ele, mantendo o que você digitou e o submenu em que você está.

Editores somente leitura

Um editor readonly não lista nenhum comando que alteraria o diagrama, em vez de listá-lo esmaecido.
Na aba ERD, ele mantém Tab, Name View, Database, Export com as suas três opções, Toggle Explorer, Theme e Display Language. Deixa de fora Import, Import and Add, as linhas de derivação, New Table, New Memo, New Table Group, Group Selected Tables, os quatro tipos de relacionamento e Auto Layout.
As outras abas listam o que listam em qualquer editor. Onde quer que sejam listados, Tab, Name View, Database, Bracket, Language e os dois estilos de nome alteram apenas aquela tela e nunca são salvos — consulte Editores somente leitura em Configurações.
Se o editor passar a ser somente 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 você digitou. Um submenu cuja linha desapareceu dá lugar ao nível superior.

Os prefixos #, @ e : pesquisam o diagrama como em qualquer editor, e um salto seleciona o que alcança, como descrito em Pesquisar no diagrama. Em um editor somente leitura, essa é a única forma de selecionar algo: pressionar no canvas não seleciona nada, e um clique sem movimento limpa o que o salto selecionou — consulte Editores somente 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 em qualquer aba. Ele só conta quando é o primeiro caractere, ignorando os espaços antes dele. Um espaço depois dele é opcional, então #users e # users são a mesma pesquisa, e os caracteres de largura total ＃, ＠, ： e ？ que um método de entrada japonês ou chinês digita também contam.
Enquanto o campo de pesquisa está vazio no nível superior, uma linha abaixo dele mostra os quatro prefixos; clique em um para digitá-lo. Enquanto um prefixo está em vigor, o final do campo indica o escopo dele: Tables, Columns, Comments & memos ou Help. Apague o prefixo para ter os comandos de volta.

# lista as tabelas, cada uma com Table ao lado. Uma linha nomeia sua tabela como faz a exibição de nomes, como Accounts (users) na exibição Both Names, e uma tabela sem nenhum nome a mostrar é listada como unnamed. Sem nada depois de #, as tabelas são ordenadas por nome, nunca por nome lógico, em todas as exibições. O texto depois de # é comparado de forma aproximada, como descrito acima, com o nome e o nome lógico de cada tabela, independentemente do que a exibição mostra, então #accounts lista users mesmo na exibição Physical Names. As tabelas cujo nome ou nome lógico contém o texto vêm primeiro. Os nomes de grupos de tabelas e de índices não são pesquisados com nenhum prefixo; Localizar e substituir pesquisa os dois.

@ lista as colunas, cada uma com sua localização ao lado, como users.email · Column. O texto depois de @ precisa aparecer no nome ou no nome lógico da coluna, sem diferenciar maiúsculas de minúsculas e independentemente do que a exibição de nomes mostra; essa 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, então uma coluna cujo nome e nome lógico contêm o texto é listada duas vezes. O texto antes do primeiro . restringe a pesquisa às tabelas cujo nome ou nome lógico o contém: @users.em lista as colunas que contêm em nas tabelas cujo nome ou nome lógico contém users, @users. lista as colunas dessas tabelas e @.em pesquisa todas as tabelas. O próprio nome lógico de uma tabela não gera nenhuma linha com @; # o encontra. Sem nada depois de @, cada coluna é listada uma vez, pelo nome.

: lista comentários de tabelas, comentários de colunas e notas, nunca nomes nem nomes lógicos. Cada linha mostra um trecho do texto em torno da correspondência, com users · Table comment, users.email · Column comment ou Memo ao lado. O texto depois de : precisa aparecer no comentário ou na nota, sem diferenciar maiúsculas de minúsculas, como com @. Sem nada depois de :, são listados os comentários e as notas que não estão vazios. Enquanto View Option → Memos oculta as notas, : não lista nenhuma nota.

@ e : listam suas linhas na ordem em que estão no documento: tabela por tabela, o comentário de cada tabela antes das colunas dela, na ordem das colunas, e as notas por último. Com @, a linha do nome lógico de uma coluna vem antes da linha do nome dela.
A localização ao lado de uma linha @ ou : indica os nomes da tabela e da coluna, nunca os nomes lógicos delas, em todas as exibições.

? lista Tables, Columns e Comments & memos, e o texto depois de ? os filtra. Escolher um deles substitui o conteúdo do campo pelo prefixo correspondente e deixa a paleta aberta.

Uma lista com prefixo contém todas as correspondências, quantas houver. Um prefixo cuja pesquisa não encontra nada deixa a lista vazia, sem nenhuma mensagem.

Escolher uma tabela, coluna, comentário ou nota fecha a paleta e muda para a aba ERD se você estiver em outra.
O canvas rola até o item, a menos que ele já esteja bem visível — consulte Onde um salto termina. Uma tabela fica então como a única selecionada e é trazida para a frente. A menos que o foco já estivesse nessa tabela, a primeira célula do cabeçalho dela recebe o foco: o nome ou, nas exibições Logical Names e Both Names, o nome lógico.
Uma nota fica como a única selecionada e é trazida para a frente. No caso de uma coluna ou de um comentário, a tabela correspondente fica como a única selecionada, é trazida para a frente e recebe o foco na célula que contém o texto. Onde a exibição não desenha essa célula, o foco vai para a célula desenhada no lugar dela: um nome lógico encontrado na exibição Physical Names leva ao nome, e um nome encontrado na exibição Logical Names, ao nome lógico. Um comentário que uma opção de exibição da tabela oculta leva ao nome ao lado dele ou, na exibição Logical Names, ao nome lógico.
Nenhum salto inicia nem conclui um relacionamento que esteja sendo desenhado.

Para Match Case, Match Whole Word ou Use Regular Expression, ou para substituir texto, use Localizar e substituir no topo do explorador.

Quando nenhum comando corresponde

No nível superior, sem prefixo, se nenhum comando listado contiver o que você digitou, sem diferenciar maiúsculas de minúsculas, três linhas aparecem depois dos comandos: Search tables for "…", Search columns for "…" e Search comments & memos for "…", cada uma com seu prefixo como ícone. Escolher uma delas digita esse prefixo antes do seu texto, então users vira #users, e a paleta continua aberta nesses resultados.
Se a pesquisa não encontrar comando algum, No commands match aparece acima da lista, que então contém só as três linhas. Se encontrar só comandos que não contêm o texto, eles vêm primeiro: na aba ERD, sem nenhuma tabela selecionada, tables lista New Table, Database e, onde é oferecido, New Table Group antes das três linhas. Com uma tabela selecionada, Group Selected Tables, onde é oferecido, contém tables, então as três linhas não aparecem.
Dentro de um submenu, uma pesquisa que não encontra nada deixa a lista vazia, sem nenhuma mensagem.

Pesquisar em coreano

Uma pesquisa que contém hangul também encontra correspondências pelas letras, nos comandos, nos submenus e com qualquer prefixo.
Cada etapa pela qual um método de entrada coreano passa continua encontrando a linha cujo texto você está digitando, então ㅅ, 사, 상, 사요 e 사용 encontram todos 사용자. Uma pesquisa feita só de consoantes iniciais corresponde às consoantes iniciais das sílabas, ignorando os espaços: ㅅㅇㅈ encontra 사용자, e ㅈㅁ encontra 주문 내역. Um grupo consonantal que um método de entrada do Windows compõe a partir de duas iniciais digitadas em sequência, como ㅄ, conta como as duas (ㅂㅅ), enquanto uma consoante dupla como ㄲ continua sendo uma única letra. O texto armazenado em forma decomposta, como ficam os nomes de arquivo no macOS, corresponde como se estivesse composto.
As linhas cujo texto inteiro forma o termo de pesquisa, letra por letra ou inicial por inicial, vêm primeiro, depois as linhas que começam com ele e depois as que o contêm. Com @ e :, as linhas que contêm o termo de pesquisa tal como foi digitado vêm antes de todas essas, na ordem do documento. O realce abrange sílabas inteiras, então 상 realça 사용 em 사용자.