MySQL DB
Resumo
- Adicione ou remova bancos de dados MySQL.
Requisitos
- mysqldump (binário, no host que será executado o módulo) - usado na ação de criação de um arquivo dump.
- mysql (binário, no host que será executado o módulo) - usado na ação de importação de um arquivo dump.
Parâmetros
Parâmetro | Tipo | Escolhas | Valor Padrão | Comentários |
|---|---|---|---|
ca_cert | string | | O caminho para um certificado de Autoridade de Certificação (CA). |
client_cert | string | | O caminho para um certificado de chave pública do client. |
client_key | string | | O caminho para a chave privada do client. |
collation | string | | Modo de agrupamento (ordenação). Por conta de uma limitação do MySQL, a opção se aplica apenas a novas tabelas / bancos de dados e não atualiza os existentes. |
config_file | string | Default: - "~/.my.cnf" | Especifique um arquivo de configuração a partir do qual o usuário e a senha devem ser lidos. É utilizada quando não são definidos um login_user e login_password. |
connect_timeout | int | Default: - 30 | Nome do banco de dados para adicionar ou remover. |
encoding | string | | Modo de codificação a ser usado. |
ignore_tables | string | Default: - [] | Uma lista de nomes de tabelas que serão ignorados no despejo do formulário database_name.table_name |
login_host | string | Default: - "localhost" | Host executando o banco de dados. |
login_password | string | | Senha usada para autenticação. |
login_port | int | Default: - 3306 | Porta do servidor MSSQL. - Para a opção ser utilizada, a opção login_host deve ser definida com um valor diferente de localhost. |
login_unix_socket | string | | O caminho para um soquete de domínio Unix para conexões locais. |
login_user | string | | Nome de usuário usado para autenticação. |
name | list | | Nome do banco de dados a ser adicionado ou removido. |
quick | boolean | Choices: - no - yes (default) | Opção usada para criar o dump de grandes tabelas. |
single_transaction | boolean | Choices: - no (default) - yes | Execute o dump em uma única transação. |
state | string | Choices: - present (default) - absent - dump - import | O estado desejado para o banco de dados. |
target | string | | Caminho do arquivo dump para ser lido ou gravado. Arquivos SQL não compactados (.sql) são suportados. |
Extende fragmentos da documentação do módulo MySQL Base.
Notas
- Ambos login_password e login_user são necessários quando você está passando credenciais, caso nenhum estiver presente, o módulo tentará ler as credenciais presentes em ~/.my.cnf e, finalmente, voltará a usar o login padrão do MySQL de ‘root’ sem senha.
Exemplos
# Create a new database with name 'bobdata'
- mysql_db:
login_user: admin
login_password: root
name: bobdata
state: present
# Create new databases with names 'foo' and 'bar'
- mysql_db:
login_user: admin
login_password: root
name:
- foo
- bar
state: present
# Copy database dump file to remote host and restore it to database 'my_db'
- copy:
login_user: admin
login_password: root
src: dump.sql.bz2
dest: /tmp
# Restore database
- mysql_db:
login_user: admin
login_password: root
name: my_db
state: import
target: /tmp/dump.sql.bz2
# Dump multiple databases
- mysql_db:
login_user: admin
login_password: root
state: dump
name: db_1,db_2
target: /tmp/dump.sql
# Dump multiple databases
- mysql_db:
login_user: admin
login_password: root
state: dump
name:
- db_1
- db_2
target: /tmp/dump.sql
# Dump all databases to hostname.sql
- mysql_db:
login_user: admin
login_password: root
state: dump
name: all
target: /tmp/dump.sql
# Import file.sql similar to mysql -u <username> -p <password> < hostname.sql
- mysql_db:
login_user: admin
login_password: root
state: import
name: all
target: /tmp/dump.sql
# Delete database with name 'bobdata'
- mysql_db:
login_user: admin
login_password: root
name: bobdata
state: absent
# Make sure there is neither a database with name 'foo', nor one with name 'bar'
- mysql_db:
login_user: admin
login_password: root
name:
- foo
- bar
state: absentValores Retornados
Chave | Tipo | Retornado quando | Descrição |
|---|---|---|---|
db | string | Sempre | Nomes de banco de dados em formato de string delimitado por espaço em branco. |
db_list | list | Sempre | Lista de nomes de banco de dados. |