Referência de comandos da CLI do Firebase para o Data Connect

A CLI Firebase é uma ferramenta que permite gerenciar e configurar produtos e serviços do Firebase na linha de comando.

A CLI fornece comandos que podem ser usados para realizar várias tarefas do Data Connect, como criar um novo projeto do Data Connect, inicializar um diretório de trabalho local correspondente, configurar o emulador do Data Connect, listar recursos do Data Connect, gerar SDKs de cliente e muito mais.

Configurar comandos

Adicionar Data Connect a um projeto do Firebase

firebase init

Use firebase init para definir uma nova configuração de projeto local. Esse fluxo de trabalho cria ou atualiza arquivos de configuração do Firebase no diretório.

firebase init

O fluxo firebase init orienta você na configuração de um serviço e um banco de dados, e, opcionalmente, na instalação do emulador Data Connect e na configuração de SDKs gerados.

Configuração do serviço e do banco de dados

Se você selecionar dataconnect para a configuração do produto, a CLI vai solicitar um novo nome e local do serviço e se você quer vincular e criar uma instância do Cloud SQL para PostgreSQL ou criar uma nova.

Se uma instância existente estiver vinculada, a CLI vai verificar se há configurações compatíveis, como a autenticação do IAM e endereços IP públicos.

Configuração do Local Emulator Suite

O fluxo da CLI oferece a opção de configurar emuladores, incluindo o emulador Data Connect.

Comandos do emulador Data Connect

Inicie o emulador Data Connect

emulators:start/exec

firebase emulators:start/exec

Use a versão Local Emulator Suite do emulador Data Connect no modo interativo com start ou o modo não interativo baseado em script com exec.

Comandos de gerenciamento de esquemas e conectores

Esta seção contém informações de referência da CLI para comandos usados para gerenciar esquemas e conectores.

Para saber como usar casos e práticas recomendadas relacionadas a esses comandos, consulte o guia de gerenciamento de esquemas e conectores.

Implantar recursos de esquema e conector

deploy

firebase deploy

Esse comando implanta recursos para serviços do Data Connect indexados em firebase.json. Uma migração de esquema será realizada, se necessário.

Comando Descrição

implantação do Firebase

Flag Descrição

–-only dataconnect

Implanta esquemas e conectores para todos os serviços do Data Connect para este projeto, mas não implanta outros recursos de produtos do Firebase.

–-only dataconnect:serviceId

Implante o esquema e os conectores para o serviço do Data Connect especificado.

–-only dataconnect:serviceId:connectorId

Implante um único conector para o serviço especificado do Data Connect.

–-only dataconnect:serviceId:schema

Implante o esquema do serviço do Data Connect especificado.

Com as flags –-only, é possível transmitir valores separados por vírgulas para implantar qualquer subconjunto de recursos.

firebase deploy --only dataconnect:service1:schema,dataconnect:service2

Listar serviços, esquemas e conectores do Data Connect

dataconnect:services:list

firebase dataconnect:services:list

Esse comando mostra informações básicas sobre os serviços, esquemas e conectores implantados em um projeto.

Comparar e migrar esquemas SQL

dataconnect:sql:diff

firebase dataconnect:sql:diff

Esse comando compara o esquema local de um serviço com o esquema atual do banco de dados do Cloud SQL correspondente. Ele mostra os comandos que seriam executados para migrar o banco de dados para o novo esquema.

Comando Descrição

firebase dataconnect:sql:diff

Flag/Parâmetro Descrição

serviceId

Especifique o serviço. Se omitido, mostra a diferença de todos os serviços no firebase.json.

dataconnect:sql:migrate

firebase dataconnect:sql:migrate

Esse comando aplica mudanças de esquema local ao banco de dados do Cloud SQL de um serviço.

Quando você configura um novo projeto Data Connect local com o arquivo dataconnect.yaml padrão, o comportamento do comando dataconect:sql:migrate é solicitar as mudanças necessárias e, em seguida, solicitar alterações opcionais antes de executá-las. É possível modificar esse comportamento para sempre incluir ou ignorar mudanças opcionais atualizando a configuração dataconnect.yaml, conforme discutido em migrar um esquema no modo estrito ou compatível.

Em ambientes interativos, a CLI exibe cada instrução SQL de migração (e se ela é destrutiva) e solicita as alterações que você quer aplicar. Transmitir a flag --force é equivalente a aceitar todos os comandos.

Em ambientes não interativos:

  • Sem --force, apenas mudanças não destrutivas são feitas. Se houver mudanças destrutivas, a CLI será abortada sem que nenhuma mudança seja feita.
  • com --force, todas as mudanças serão feitas. Se isso incluir alterações destrutivas, elas serão impressas e você será solicitado a continuar, a menos que a flag --force seja fornecida.
Comando Descrição

firebase dataconnect:sql:migrate

Flag Descrição

serviceId

Migre o banco de dados para o serviço especificado. O serviceId é inferido se o projeto tiver apenas um serviço.

–-força

Aceitar automaticamente as solicitações.

Assim como com outras flags --only, é possível fornecer vários serviços separados por vírgulas.

Migrar um esquema no modo restrito ou compatível

As migrações de esquema Data Connect têm dois modos de validação de esquema diferentes: restrito e compatível. A validação do modo rigoroso exige que o esquema do banco de dados corresponda exatamente ao esquema do aplicativo antes que o esquema do aplicativo possa ser implantado. A validação do modo compatível exige que o esquema do banco de dados seja compatível com o esquema do aplicativo, o que significa que os elementos do banco de dados que não são usados pelo esquema do aplicativo não são modificados.

Esses modos de validação de esquema e as práticas recomendadas para migração de esquema são abordados no guia de gerenciamento de esquemas e conectores.

O modo de validação é definido usando a chave schemaValidation no arquivo dataconnect.yaml. Se schemaValidation não for especificado, a CLI vai aplicar mudanças compatíveis e solicitar que você as execute antes de fazer mudanças rígidas. Consulte a referência de configuração.

Comandos do SDK

Gerar SDKs

dataconnect:sdk:generate

firebase dataconnect:sdk:generate

Esse comando gera os SDKs tipados declarados em connector.yaml.

Consulte também os guias para trabalhar com os SDKs da Web, SDKs do Android e SDKs para iOS.

Comando Descrição

firebase dataconnect:sdk:generate

Flag Descrição

--relógio

Mantém o processo em execução e gera novos SDKs sempre que você salva mudanças nos arquivos GQL do esquema e do conector.

Se a geração falhar, os erros serão impressos em stdout, e o código gerado não será alterado, e o comando continuará em execução.

–-only connectorId:platform

Gerar SDKs apenas para uma plataforma e um conector.

Com as flags –only, é possível transmitir valores separados por vírgulas.

firebase dataconnect:sdk:generate –-only connector1, connector1:kotlin

Comandos de gerenciamento do Cloud SQL

Conceder papéis do SQL para o Cloud SQL

dataconnect:sql:grant

firebase dataconnect:sql:grant

Data Connect opera na sua própria instância do PostgreSQL hospedada no Cloud SQL. Em alguns casos, convém acessar o banco de dados diretamente para consultar ou atualizar os dados gerados pelos seus apps Data Connect. Para fazer isso, conceda uma das funções definidas nesta seção ao usuário ou à conta de serviço necessária.

Para saber mais sobre os papéis concedidos, consulte Papéis de usuário do PostgreSQL.

Papel Função SQL Permissões Uso Pode ser concedido
leitor firebasereader_<db_name>_<schema_name> Acesso somente leitura ao banco de dados.

Pode realizar operações SELECT em todas as tabelas do esquema especificado.
Ideal para usuários ou serviços que exigem a recuperação de dados, mas não a modificação. Sim
escritor firebasewriter_<db_name>_<schema_name> Acesso de leitura e gravação ao banco de dados.

Pode executar operações SELECT, INSERT, UPDATE, DELETE e TRUNCATE em todas as tabelas do esquema.
Adequado para usuários ou serviços que precisam modificar dados no banco de dados. Sim
proprietário firebaseowner_<db_name>_<schema_name> Proprietário do esquema.

Tem todos os privilégios em todas as tabelas e sequências do esquema.
Esse papel, em combinação com o papel roles/cloudsql.client do IAM, concede permissão para realizar a migração no banco de dados.

Por exemplo, ao chamar firebase dataconnect:sql:migrate.
Sim
superusuário cloudsqlsuperuser Função de superusuário integrada com privilégios totais no banco de dados.

Além das permissões de proprietário, ela pode criar esquemas, excluir esquemas, instalar extensões e realizar outras tarefas administrativas.

Acessado pela CLI fazendo login como "firebasesuperuser".
É necessário para instalar extensões, criar o esquema inicial e conceder a qualquer uma das funções SQL concedíveis a outros usuários.

Se um usuário que não é administrador precisar de privilégios de superusuário, a migração falhará e solicitará que o usuário peça ao administrador do banco de dados (por exemplo, um usuário com roles/cloudsql.admin) para executar os comandos SQL com privilégios.
Concedido a usuários com roles/cloudsql.admin e não pode ser concedido diretamente pela CLI Firebase
Comando Descrição

firebase dataconnect:sql:grant

Flag/parâmetro Descrição

-R, --role role

O papel do SQL a ser concedido: proprietário, gravador ou leitor.

-E, --email email_address

E-mail de um usuário ou de uma conta de serviço para conceder o papel.

Opções globais

As opções globais a seguir se aplicam a todos os comandos:

  • --json alterna a saída da CLI para JSON para análise por outras ferramentas.
  • --noninteractive e --interactive substituem, conforme necessário, a detecção automática de ambientes que não são TTY.