> ## 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.

# Compilar Percona

> VillageSQL compilado sobre o Percona Server para MySQL 8.4.

O VillageSQL também é compilado sobre o **Percona Server**, um fork do MySQL
compatível em nível de código-fonte que acrescenta seus próprios recursos de
armazenamento, desempenho e observabilidade.

<h2 id="what-this-is">
  O que é isto
</h2>

Um servidor VillageSQL compilado com a base de código do Percona 8.4 em vez do
MySQL 8.4 upstream. O VillageSQL Extension Framework, seus comandos SQL e suas
extensões funcionam da mesma maneira nas duas — uma compilação Percona é uma
fundação diferente sob a mesma superfície do VillageSQL.

O VillageSQL não documenta os recursos do próprio Percona. Para qualquer
assunto sobre o Percona Server em si — seus mecanismos de armazenamento,
opções de ajuste ou configuração — consulte a
[documentação do próprio Percona](https://docs.percona.com/percona-server/8.4/).

<h2 id="identifying-a-percona-build">
  Identificando uma compilação Percona
</h2>

Uma compilação Percona informa uma base de código diferente em sua string de
versão:

```sql theme={null}
SELECT @@villagesql_server_version;
-- Example output: percona-8.4_0.0.6
```

Consulte [Referência do Sistema](/docs/pt-BR/mysql-8.4/stable/reference#villagesql_server_version)
para saber o que essa variável significa. O VillageSQL se recusa a atualizar um
diretório de dados de uma base de código (por exemplo, `mysql-8.4`) em um
servidor que executa outra (por exemplo, `percona-8.4`).

<h2 id="installing">
  Instalando
</h2>

A compilação Percona é publicada junto com a compilação MySQL 8.4, e os três métodos de instalação a oferecem.

**Script de instalação.** Responda **Percona 8.4** na primeira pergunta, ou indique-a diretamente quando não houver terminal:

```bash theme={null}
curl -fsSL https://install.villagesql.com | \
  VSQL_CODEBASE=percona-8.4 INSTALL_METHOD=prebuilt bash
```

**Docker.** As imagens são publicadas por base de código e por arquitetura:

```bash theme={null}
docker run -d --name vsql -e MYSQL_ALLOW_EMPTY_PASSWORD=yes -p 3306:3306 villagesql/server:percona-8.4_0.0.6-$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')
```

**Download da release.** Os arquivos `villagesql-dev-server-percona-8.4_0.0.6-<os>-<arch>.tar.gz` na [release 0.0.6](https://github.com/villagesql/villagesql-server/releases/tag/release/0.0.6) cobrem Linux em x86\_64 e aarch64, e macOS em arm64.

**Código-fonte.** Compile o branch `percona-8.4`, ou a tag `publish/percona-8.4_0.0.6` para o código exato que a release entregou — veja [Compilar a partir do código-fonte](/docs/pt-BR/mysql-8.4/stable/source) para os passos da compilação.

Um diretório de dados pertence à base de código que o criou. O VillageSQL recusa abrir um diretório de dados `mysql-8.4` com um servidor `percona-8.4`, portanto instale esta compilação em seu próprio diretório em vez de apontá-la para um diretório existente.