MySQL DB

6 min

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: absent

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