> ## Documentation Index
> Fetch the complete documentation index at: https://villagesql.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Guias do MySQL

> Guias práticos de MySQL para desenvolvedores. Cobrem modelagem de dados, consultas, segurança, desempenho, integração com IA e operações do dia a dia.

O MySQL tem um escopo enorme. Estes guias se concentram nas partes que aparecem com mais frequência — desde as decisões que você toma uma única vez antes da sua primeira migração até as técnicas que você usa toda semana. Cada um deles é prático e funciona com o VillageSQL.

Novo em SQL? O [tutorial de MySQL](https://villagesql.com/docs/pt-BR/tutorial/index.md) ensina a linguagem em ordem, uma lição de cada vez, sobre um único banco de dados de exemplo. Se você já escreve SQL, comece por [escolher tipos de dados](https://villagesql.com/docs/pt-BR/guides/choosing-data-types.md), [joins](https://villagesql.com/docs/pt-BR/guides/joins.md) e [índices](https://villagesql.com/docs/pt-BR/guides/mysql-indexes.md) — eles cobrem os fundamentos sobre os quais todo o resto se apoia.

## Compare o MySQL e o PostgreSQL

* [Como o MySQL e o PostgreSQL se comparam, e como escolher](https://villagesql.com/docs/pt-BR/guides/mysql-vs-postgresql.md)

## Armazene Dados

As decisões sobre colunas e esquema são difíceis de desfazer depois que os dados estão em produção. Estes guias cobrem tipos de coluna, estratégias de chave primária, restrições e os tipos habilitados pelo framework de extensões do VillageSQL — como UUIDs nativos e tipos de endereço de rede.

* [Como gerar e armazenar UUIDs de forma eficiente](https://villagesql.com/docs/pt-BR/guides/uuids.md)
* [Como escolher entre auto-incremento, UUIDs e chaves compostas](https://villagesql.com/docs/pt-BR/guides/primary-key-strategies.md)
* [Como armazenar endereços IPv4 e IPv6 de forma eficiente](https://villagesql.com/docs/pt-BR/guides/storing-ip-addresses.md)
* [Como armazenar e consultar endereços MAC no MySQL](https://villagesql.com/docs/pt-BR/guides/storing-mac-addresses.md)
* [Como lidar com endereços IPv6 nativamente com o VillageSQL](https://villagesql.com/docs/pt-BR/guides/ipv6-storage.md)
* [Como armazenar, consultar e manipular documentos JSON](https://villagesql.com/docs/pt-BR/guides/json-in-mysql.md)
* [Como escolher o tipo de coluna certo para os seus dados](https://villagesql.com/docs/pt-BR/guides/choosing-data-types.md)
* [Como armazenar um booleano de verdade em vez de TINYINT(1)](https://villagesql.com/docs/pt-BR/guides/boolean-columns.md)
* [Como os conjuntos de caracteres e as collations afetam os seus dados](https://villagesql.com/docs/pt-BR/guides/character-sets.md)
* [Como lidar corretamente com fusos horários nos timestamps do MySQL](https://villagesql.com/docs/pt-BR/guides/timestamps-timezones.md)
* [Como estruturar o seu esquema com normalização de banco de dados](https://villagesql.com/docs/pt-BR/guides/normalization.md)
* [Como garantir a integridade referencial com chaves estrangeiras](https://villagesql.com/docs/pt-BR/guides/foreign-keys.md)
* [Como calcular e indexar valores derivados com colunas geradas](https://villagesql.com/docs/pt-BR/guides/generated-columns.md)
* [Como validar dados no nível do banco de dados com restrições CHECK](https://villagesql.com/docs/pt-BR/guides/check-constraints.md)
* [Como implementar soft deletes com uma coluna deleted\_at](https://villagesql.com/docs/pt-BR/guides/soft-deletes.md)
* [Como armazenar emoji e Unicode completo com utf8mb4](https://villagesql.com/docs/pt-BR/guides/utf8mb4.md)

## Escreva Consultas

Estes guias cobrem o SQL que você vai escrever com mais frequência, de JOINs e agregações a funções de janela, CTEs e busca de texto completo. Os guias específicos do VillageSQL incluem consultas por sub-rede IP e o enriquecimento de resultados com funções HTTP e de IA.

* [Como fazer um JOIN lento ou errado se comportar](https://villagesql.com/docs/pt-BR/guides/joins.md)
* [Como decidir entre subconsultas e JOINs](https://villagesql.com/docs/pt-BR/guides/subqueries-vs-joins.md)
* [Como saber se uma CTE está ajudando ou atrapalhando](https://villagesql.com/docs/pt-BR/guides/ctes-in-mysql.md)
* [Como tornar um GROUP BY lento rápido](https://villagesql.com/docs/pt-BR/guides/group-by-having.md)
* [Como calcular totais acumulados, classificações e médias móveis com funções de janela](https://villagesql.com/docs/pt-BR/guides/window-functions.md)
* [Como o NULL se comporta no MySQL e como lidar com ele corretamente](https://villagesql.com/docs/pt-BR/guides/null-in-mysql.md)
* [Como implementar busca de texto completo no MySQL](https://villagesql.com/docs/pt-BR/guides/full-text-search.md)
* [Como simplificar consultas complexas com views](https://villagesql.com/docs/pt-BR/guides/views.md)
* [Como inserir ou atualizar linhas em uma única instrução com upsert](https://villagesql.com/docs/pt-BR/guides/upsert.md)
* [Como paginar grandes conjuntos de resultados com paginação por keyset e OFFSET](https://villagesql.com/docs/pt-BR/guides/pagination.md)
* [Como manipular e transformar strings em SQL](https://villagesql.com/docs/pt-BR/guides/string-functions.md)
* [Como trabalhar com datas e horas em consultas MySQL](https://villagesql.com/docs/pt-BR/guides/date-time-functions.md)
* [Como consultar e filtrar por sub-rede IP no MySQL](https://villagesql.com/docs/pt-BR/guides/subnet-queries.md)
* [Como fazer consultas de geolocalização por endereço IP no MySQL](https://villagesql.com/docs/pt-BR/guides/ip-geolocation.md)
* [Como fazer requisições HTTP diretamente do MySQL](https://villagesql.com/docs/pt-BR/guides/http-requests-in-mysql.md)
* [Como enriquecer resultados de consultas com dados de APIs REST externas](https://villagesql.com/docs/pt-BR/guides/rest-api-enrichment.md)
* [Como armazenar e consultar dados multidimensionais com o tipo cube](https://villagesql.com/docs/pt-BR/guides/cube-queries.md)
* [Como encontrar strings semelhantes com similaridade de trigramas no MySQL](https://villagesql.com/docs/pt-BR/guides/trigram-similarity.md)
* [Como comparar nomes foneticamente e por distância de edição no MySQL](https://villagesql.com/docs/pt-BR/guides/fuzzy-string-matching.md)

## Proteja Dados

A extensão de criptografia do VillageSQL traz bcrypt, criptografia AES, assinatura HMAC e funções de digest para o SQL. Estes guias cobrem essas funções criptográficas junto com o gerenciamento interno de usuários e privilégios do MySQL.

* [Como fazer hashing de senhas com segurança usando bcrypt e Argon2](https://villagesql.com/docs/pt-BR/guides/password-hashing.md)
* [Como gerar checksums e digests para integridade de dados](https://villagesql.com/docs/pt-BR/guides/hashing-data.md)
* [Como criptografar dados sensíveis de colunas no nível do banco de dados](https://villagesql.com/docs/pt-BR/guides/encrypting-columns.md)
* [Como criptografar e descriptografar dados com AES no MySQL](https://villagesql.com/docs/pt-BR/guides/symmetric-encryption.md)
* [Como assinar e verificar dados com HMAC no MySQL](https://villagesql.com/docs/pt-BR/guides/hmac-mysql.md)
* [Como gerar valores aleatórios criptograficamente seguros](https://villagesql.com/docs/pt-BR/guides/random-data-mysql.md)
* [Como criar e gerenciar usuários e privilégios do MySQL](https://villagesql.com/docs/pt-BR/guides/user-management.md)
* [Como permitir que usuários façam login com um JWT em vez de uma senha](https://villagesql.com/docs/pt-BR/guides/jwt-authentication.md)
* [Como fazer o hardening de um servidor MySQL para produção](https://villagesql.com/docs/pt-BR/guides/security-hardening.md)

## Otimize o Desempenho

Consultas lentas costumam ser um problema de indexação ou de esquema. Estes guias cobrem como diagnosticá-las — usando a saída do EXPLAIN, o log de consultas lentas e a compreensão de como o InnoDB armazena dados — e o que mudar.

* [Como diagnosticar e corrigir consultas MySQL lentas](https://villagesql.com/docs/pt-BR/guides/mysql-query-performance.md)
* [Como os índices funcionam e quando usá-los](https://villagesql.com/docs/pt-BR/guides/mysql-indexes.md)
* [Como ler e agir sobre a saída do EXPLAIN do MySQL](https://villagesql.com/docs/pt-BR/guides/reading-explain.md)
* [Como os índices de cobertura eliminam acessos à tabela](https://villagesql.com/docs/pt-BR/guides/covering-indexes.md)
* [Como encontrar e corrigir consultas lentas com o log de consultas lentas](https://villagesql.com/docs/pt-BR/guides/slow-query-log.md)
* [Como gerenciar conexões de banco de dados com eficiência usando pool de conexões](https://villagesql.com/docs/pt-BR/guides/connection-pooling.md)
* [Como o InnoDB armazena dados e por que isso importa para o desempenho](https://villagesql.com/docs/pt-BR/guides/innodb-storage.md)
* [Como inserir grandes volumes de dados rapidamente](https://villagesql.com/docs/pt-BR/guides/bulk-inserts.md)
* [Como particionar tabelas grandes para melhorar o desempenho das consultas](https://villagesql.com/docs/pt-BR/guides/table-partitioning.md)

## Construa com IA

A extensão de IA do VillageSQL permite chamar modelos de linguagem e gerar embeddings diretamente do SQL. Estes guias cobrem a configuração dos provedores e como usar `ai_prompt()` e `ai_embedding()` em consultas reais.

* [Como configurar as credenciais de provedores de IA para o VillageSQL](https://villagesql.com/docs/pt-BR/guides/ai-api-setup.md)
* [Como chamar modelos de IA diretamente do SQL com ai\_prompt()](https://villagesql.com/docs/pt-BR/guides/ai-prompts-in-mysql.md)
* [Como gerar e armazenar embeddings vetoriais no MySQL](https://villagesql.com/docs/pt-BR/guides/vector-embeddings.md)
* [Como classificar texto usando IA de dentro do MySQL](https://villagesql.com/docs/pt-BR/guides/text-classification.md)
* [Como executar análise de sentimento com funções de IA no MySQL](https://villagesql.com/docs/pt-BR/guides/sentiment-analysis.md)
* [Como resumir texto com IA diretamente no SQL](https://villagesql.com/docs/pt-BR/guides/ai-summarization.md)
* [Como conectar um agente de IA ao MySQL com MCP](https://villagesql.com/docs/pt-BR/guides/mysql-ai-agents-mcp.md)

## Opere o MySQL

Estes guias cobrem o lado operacional: migrações de esquema, configuração do Docker, transações, replicação, backups e o que fazer quando algo dá errado em produção.

* [Como atualizar o MySQL com o mínimo de tempo de inatividade](https://villagesql.com/docs/pt-BR/guides/upgrade.md)
* [Como atualizar do MySQL 8.0 para o 8.4 após o fim do suporte](https://villagesql.com/docs/pt-BR/guides/mysql-80-eol-upgrade.md)
* [Como migrar do PostgreSQL para o MySQL](https://villagesql.com/docs/pt-BR/guides/postgres-to-mysql.md)
* [Como migrar do MariaDB para o MySQL](https://villagesql.com/docs/pt-BR/guides/mariadb-to-mysql-migration.md)
* [Como gerenciar alterações de esquema com segurança em produção](https://villagesql.com/docs/pt-BR/guides/schema-migrations.md)
* [Como executar ALTER TABLE em uma tabela em produção sem tempo de inatividade](https://villagesql.com/docs/pt-BR/guides/zero-downtime-schema-changes.md)
* [Como configurar Django, Rails e Prisma para o MySQL](https://villagesql.com/docs/pt-BR/guides/mysql-with-orms.md)
* [Como executar o MySQL no Docker para desenvolvimento local e produção](https://villagesql.com/docs/pt-BR/guides/mysql-on-docker.md)
* [Como testar contra um servidor MySQL real com Testcontainers](https://villagesql.com/docs/pt-BR/guides/testing-with-testcontainers.md)
* [Como executar o MySQL no Kubernetes](https://villagesql.com/docs/pt-BR/guides/mysql-on-kubernetes.md)
* [Como usar transações para manter os seus dados consistentes](https://villagesql.com/docs/pt-BR/guides/transactions.md)
* [Como detectar, prevenir e se recuperar de deadlocks](https://villagesql.com/docs/pt-BR/guides/deadlocks.md)
* [Como corrigir os erros mais comuns do MySQL](https://villagesql.com/docs/pt-BR/guides/common-mysql-errors.md)
* [Como escrever e usar stored procedures no MySQL](https://villagesql.com/docs/pt-BR/guides/stored-procedures.md)
* [Como automatizar ações com triggers do MySQL](https://villagesql.com/docs/pt-BR/guides/triggers.md)
* [Como enviar webhooks a partir de triggers do MySQL](https://villagesql.com/docs/pt-BR/guides/http-webhooks.md)
* [Como consultar os metadados do MySQL com INFORMATION\_SCHEMA](https://villagesql.com/docs/pt-BR/guides/information-schema.md)
* [Como fazer backup e restaurar bancos de dados MySQL](https://villagesql.com/docs/pt-BR/guides/backup-strategies.md)
* [Como a replicação do MySQL funciona e como configurá-la](https://villagesql.com/docs/pt-BR/guides/replication-basics.md)
* [Como escalar leituras com réplicas de leitura do MySQL](https://villagesql.com/docs/pt-BR/guides/read-replicas.md)
* [Como o log binário funciona e como usá-lo para recuperação pontual](https://villagesql.com/docs/pt-BR/guides/binary-logging.md)

## Conecte uma Aplicação

Cada framework chega ao MySQL de um jeito um pouco diferente. Cada um destes guias constrói uma pequena aplicação funcional contra um servidor real e cobre as etapas de configuração que são fáceis de errar na primeira vez: escolha do driver, migrações, pool de conexões e onde o pool precisa ficar.

* [Como conectar o Next.js ao MySQL com Prisma](https://villagesql.com/docs/pt-BR/guides/mysql-with-prisma.md)
* [Como conectar o Next.js ao MySQL com Drizzle](https://villagesql.com/docs/pt-BR/guides/mysql-with-drizzle.md)
* [Como conectar o Next.js ao MySQL sem ORM](https://villagesql.com/docs/pt-BR/guides/nextjs-mysql.md)
* [Como conectar o FastAPI ao MySQL com SQLAlchemy 2.0](https://villagesql.com/docs/pt-BR/guides/fastapi-sqlalchemy-mysql.md)
* [Como conectar o Laravel ao MySQL com Eloquent](https://villagesql.com/docs/pt-BR/guides/laravel-mysql.md)
* [Como conectar o Rails ao MySQL com ActiveRecord](https://villagesql.com/docs/pt-BR/guides/rails-mysql.md)
* [Como gerar consultas MySQL com tipagem segura em Go com sqlc](https://villagesql.com/docs/pt-BR/guides/go-sqlc-mysql.md)
* [Como impedir que um runtime serverless esgote as conexões do MySQL](https://villagesql.com/docs/pt-BR/guides/serverless-mysql-drizzle.md)
* [Como expor tabelas do MySQL como uma API REST](https://villagesql.com/docs/pt-BR/guides/rest-api-from-tables.md)

## Escreva Extensões

O framework de extensões do VillageSQL permite adicionar funções e tipos personalizados ao MySQL sem tocar no código do servidor. Estes guias levam você do zero a uma extensão instalável.

* [Como construir uma extensão do VillageSQL em C++](https://villagesql.com/docs/pt-BR/guides/cpp-extensions.md)
* [Como construir uma extensão do VillageSQL em Rust](https://villagesql.com/docs/pt-BR/guides/rust-extensions.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.