Saltar al contenido principal

Instantánea de Cuentas

Metadatos de la Tabla

PropiedadConfiguración
Clave Naturalaccount_id, valid_from
Campo(s) de particiónvalid_to (partición MENSUAL)
Campo(s) agrupadosaccount_id
Documentacióndbt docs

Detalles de Columnas

NombreDescripciónTipo de DatosValores del Dominio¿Requerido?Notas
account_idEl identificador único de la cuenta.STRING
balanceLa cantidad de unidades de XLM que posee la cuenta.FLOATLa tabla accounts solo reporta saldos monetarios para XLM. Cualquier otra clase de activo se informa en la tabla trust_lines.
buying_liabilitiesLa suma de todas las ofertas de compra que posee esta cuenta solo para XLM.FLOATLa tabla accounts solo reporta saldos monetarios para XLM. Cualquier otra clase de activo se informa en la tabla trust_lines. Para ofertas de compra, la cuenta debe poseer la cantidad de activo para completar la transacción.
selling_liabilitiesLa suma de todas las ofertas de venta que posee esta cuenta solo para XLM.FLOATLa tabla accounts solo reporta saldos monetarios para XLM. Cualquier otra clase de activo se informa en la tabla trust_lines.
sequence_numberEl número de secuencia actual de la cuenta. El número de secuencia controla las operaciones aplicadas a una cuenta. Las operaciones deben enviar un número de secuencia único incrementado en 1.INTEGERClave Natural. Campo Requerido.
num_subentriesEl número total de entradas ledger vinculadas a esta cuenta. Las entradas ledger incluyen: trustlines, ofertas, signatarios y entradas de datos.INTEGERCada entrada en un ledger ocupa espacio, que es costoso de almacenar. El saldo mínimo se calcula como (2 + num_subentries - num_sponsoring + num_sponsored) * 0.5XLM.
inflation_destinationObsoleto: La dirección de la cuenta para recibir un pago de inflación cuando se desembolsa.STRINGLa inflación se discontinuó en 2019 por voto de los validadores.
flagsIndica la habilitación/deshabilitación de ciertos privilegios del emisor del activo.INTEGER
  • 0 - Ninguno, por defecto
  • 1 - Autenticación requerida (todas las trustlines por defecto no son confiables y requieren establecimiento manual de confianza)
  • 2 - Autenticación revocable (permite revocar trustlines si la cuenta ya no confía en el activo)
  • 4 - Autenticación inmutable (todas las flags de autenticación son solo lectura cuando se establecen)
  • 8 - Autenticación con recuperación habilitada (el activo puede ser recuperado del usuario)
Las flags pueden tener valores: 0=Ninguno, 1=Autenticación requerida, 2=Autenticación revocable, 4=Autenticación inmutable, 8=Autenticación con recuperación habilitada.
home_domainURL del dominio principal vinculado a la billetera.STRING
master_weightEl peso de la clave maestra, que es la llave privada de esta cuenta.INTEGEREnteros desde 1 hasta 255Si la clave maestra = 0, la cuenta está bloqueada.
threshold_lowLa suma del peso de todas las firmas requeridas para operaciones de umbral bajo.INTEGERBajo: Permitir confianza, establecer flags de trust line, incrementar secuencia, reclamar saldo reclutable.
threshold_mediumLa suma del peso de todas las firmas requeridas para operaciones de umbral medio.INTEGERMedio: Todo lo demás.
threshold_highLa suma del peso de todas las firmas requeridas para operaciones de umbral alto.INTEGERAlto: Fusión de cuentas, establecer opciones.
last_modified_ledgerEl número de secuencia ledger cuando la entrada ledger fue modificada por última vez.INTEGERClave Natural. Campo agrupado. La eliminación no cuenta como modificación.
ledger_entry_changeCódigo que describe el tipo de cambio aplicado a la entrada ledger.INTEGER
  • 0 - Entrada ledger creada
  • 1 - Entrada ledger actualizada
  • 2 - Entrada ledger eliminada
  • 3 - Estado de entrada ledger (valor de la entrada)
Valores: 0=Creada, 1=Actualizada (no válido para saldos reclutables), 2=Eliminada.
deletedIndica si la entrada ledger ha sido eliminada.BOOLEANUna vez eliminada, no puede recuperarse.
sponsorLa dirección de la cuenta del patrocinador que paga las reservas para esta entrada ledger.STRINGNoLos patrocinadores pueden ser cuentas, firmantes, saldos reclutables o líneas de confianza.
num_sponsoredEl número de reservas patrocinadas para esta cuenta.INTEGERNoPor defecto es 0.
num_sponsoringEl número de reservas patrocinadas por esta cuenta.INTEGERNoPor defecto es 0.
sequence_ledgerEl número ledger sin signo de 32 bits que indica la antigüedad del número de secuencia.INTEGERNoRefleja la última vez que una cuenta tocó su número de secuencia.
sequence_timeTIMESTAMPNo
batch_idRepresentación en cadena del id de ejecución para un DAG dado en Airflow. Toma la forma de scheduled__<batch_end_date>-<dag_alias>. Los ids de lote son únicos para el lote y ayudan con la supervisión y capacidades de reejecución.string
batch_run_dateLa fecha de inicio para el intervalo del lote.DATETIMERepresenta el intervalo de ledgers procesados.
closed_atMarca de tiempo en UTC cuando este ledger se cerró y confirmó.TIMESTAMPLos ledgers cierran aproximadamente cada 5 segundos.
ledger_sequenceEl número de secuencia de este ledger.INTEGERCampo agrupado. Único por ledger.
batch_insert_tsLa marca temporal en UTC cuando un lote de registros se insertó en la base de datos.TIMESTAMPÚtil para ingeniería de datos, no para análisis ad hoc.
airflow_start_tsLa marca temporal cuando inicia el trabajo airflow.STRINGSe usa para detectar trabajos de llenado histórico.
valid_fromLa marca temporal cuando esta fila de imagen fue insertada por primera vez y se volvió efectiva.TIMESTAMPAyuda a rastrear cambios en el tiempo.
valid_toLa marca temporal cuando esta fila deja de ser válida.TIMESTAMPNoSi es nulo, la configuración está actualmente activa.

Ejemplos de Preguntas Comerciales

  1. Consulta en un punto en el tiempo (saldo al momento)
SELECT account_id, balance
FROM `crypto-stellar.snapshots.accounts_snapshot`
WHERE account_id = 'ACC123'
DATE('2025-01-15') BETWEEN DATE(valid_from) AND COALESCE(DATE(valid_to), '9999-12-31')
LIMIT 100
  1. Instantánea activa (solo registros actuales)
SELECT account_id, balance, home_domain
FROM `crypto-stellar.snapshots.accounts_snapshot`
WHERE valid_to IS NULL
LIMIT 100
  1. Cambios en febrero de 2025 (poda de particiones)
SELECT account_id, COUNT(*) AS num_changes
FROM `crypto-stellar.snapshots.accounts_snapshot`
WHERE DATE_TRUNC(valid_to, MONTH) = '2025-02-01'
GROUP BY account_id
LIMIT 100