database namespace

Funções

Função	Descrição
instance(instance)	Registra uma função que é acionada em eventos de uma instância específica do Firebase Realtime Database.
ref(path) (link em inglês)	Registra uma função que é acionada em eventos de gravação do Firebase Realtime Database.

Classes

Turma	Descrição
DataSnapshot (em inglês)	Interface que representa um snapshot de dados do Firebase Realtime Database.
InstanceBuilder (link em inglês)	Interface do criador de instâncias do Firebase Realtime Database.Acesse via [database.instance()](providers_database_.html#instance).
RefBuilder (link em inglês)	Interface do criador de referências do Firebase Realtime Database.Acesse via [functions.database.ref()](functions.database#.ref).

database.instance()

Registra uma função que é acionada em eventos de uma instância específica do Firebase Realtime Database.

Use esse método com ref para especificar a instância a ser monitorada para eventos do banco de dados. Por exemplo: firebase.database.instance('my-app-db-2').ref('/foo/bar')

Observe que functions.database.ref usado sem instance monitora a instância *padrão* em busca de eventos.

Assinatura:

export declare function instance(instance: string): InstanceBuilder;

Parâmetros

Parâmetro	Tipo	Descrição
instância	string	O nome da instância do banco de dados a ser observada para eventos de gravação.

Retorna:

InstanceBuilder (link em inglês)

Interface do criador de instâncias do Firebase Realtime Database.

database.ref().

Registra uma função que é acionada em eventos de gravação do Firebase Realtime Database.

Esse método se comporta de maneira muito semelhante ao método de mesmo nome no cliente e nos SDKs Admin do Firebase. Qualquer alteração no banco de dados que afete os dados no path fornecido ou abaixo dele acionará um evento no Cloud Functions.

Há três diferenças importantes entre detectar um evento do Realtime Database no Cloud Functions e usar o Realtime Database no cliente e nos SDKs Admin:

1. O Cloud Functions permite caracteres curinga no nome path. Qualquer componente path entre chaves ({}) é um caractere curinga que corresponde a todas as strings. O valor correspondente a uma determinada invocação de uma função do Cloud é retornado como parte do objeto [EventContext.params](cloud_functions_eventcontext.html#params). Por exemplo, ref("messages/{messageId}") corresponde às mudanças em /messages/message1 ou /messages/message2, resultando em event.params.messageId definido como "message1" ou "message2", respectivamente.

2. O Cloud Functions não dispara um evento para dados que já existiam antes da implantação da função.

3. Os eventos da função do Cloud têm acesso a mais informações, incluindo um snapshot dos dados de eventos anteriores e informações sobre o usuário que acionou a função do Cloud.

Assinatura:

export declare function ref<Ref extends string>(path: Ref): RefBuilder<Ref>;

Parâmetros

Parâmetro	Tipo	Descrição
path	Ref	O caminho no banco de dados para observar eventos de gravação.

Retorna:

RefBuilder<Ref>

Interface do builder do Firebase Realtime Database.