Skip to content

Compartir datos ​

Comparte espacios de proyecto y bases de datos con otros usuarios de Crow. Tres modos te dan control sobre cuántos datos viajan y quién puede acceder a ellos.

Estado actual de entrega (Fase 1)

El modo clonación es el único disponible hoy para compartir espacios de proyecto (crow_share con share_type: "project", mode: "clone"). El paquete incluye los metadatos del proyecto, fuentes, notas, registro de auditoría, manifiestos de backends de datos (solo nombres de variables de entorno — sin secretos) y un manifiesto de archivos de almacenamiento con URLs prefirmadas de 24 horas. El destinatario obtiene un proyecto independiente con un slug -clone-N; los cambios posteriores en cualquiera de los dos lados no se sincronizan.

Suscripción y lectura federada son hitos planificados a futuro — requieren infraestructura nueva (un feed de Hypercore por proyecto con filtrado a nivel de fila para suscripción; autenticación de proxy en el gateway + enrutamiento de consultas para lectura federada). Las descripciones de abajo son el diseño objetivo, no la implementación actual.

Modos de compartición ​

ModoEstadoQué sucedeIdeal para
ClonaciónDisponible (Fase 1)Se envía una copia completa de la base de datos / proyecto al destinatario. Recibe un snapshot independiente.Entregas únicas, datasets pequeños, acceso sin conexión
Lectura federadaPlanificado (Fase 2+)El destinatario consulta tu base de datos de forma remota a través del proxy del gateway. No se copia ningún dato.Datasets grandes, datos en vivo, acceso controlado
SuscripciónPlanificado (Fase 2+)El destinatario recibe actualizaciones continuas a medida que modificas la base de datos de origen.Proyectos colaborativos, datos de referencia compartidos

Clonación ​

Una clonación envía una copia completa de un archivo de base de datos a un contacto. El destinatario obtiene su propia copia independiente — los cambios que haga no afectan tu original.

"Clona mi base de datos county-data y compártela con Robin"

La IA usa crow_share con share_type: "database" y mode: "clone". El archivo de base de datos se transfiere a través de Hypercore, el mismo canal P2P que se usa para compartir memorias.

Cuándo clonar ​

  • El dataset es lo bastante pequeño para transferirse con comodidad (menos de ~500 MB)
  • El destinatario necesita acceso sin conexión
  • Quieres entregar un dataset sin mantener una conexión

Lectura federada ​

La lectura federada le da a un contacto permiso para ejecutar consultas de solo lectura contra tu base de datos a través del proxy del gateway. No se copia ningún dato — las consultas se ejecutan en tu máquina y solo los resultados viajan por la red.

"Dale a Robin acceso de lectura a mi base de datos tax-filings"

El destinatario puede entonces consultar tu base de datos desde su propia IA o su Data Dashboard. Las solicitudes se autentican con tokens bearer y están sujetas al mismo modelo de seguridad que las consultas locales.

Cuándo federar ​

  • El dataset es grande y clonarlo sería poco práctico
  • Quieres que el destinatario siempre vea los datos más recientes
  • Necesitas poder revocar el acceso más adelante sin perseguir copias

Revoca el acceso en cualquier momento:

"Revoca el acceso de Robin a mi base de datos tax-filings"

Suscripción ​

Una suscripción es un canal de sincronización persistente. Cuando actualizas la base de datos de origen, los cambios se propagan al suscriptor automáticamente a través de la replicación de Hypercore.

"Suscribe a Robin a las actualizaciones de mi base de datos county-data"

Las suscripciones son unidireccionales — el suscriptor recibe tus cambios, pero sus modificaciones locales (si las hay) no fluyen de vuelta hacia ti.

Cuándo suscribir ​

  • Varias personas necesitan el mismo dataset de referencia siempre actualizado
  • Mantienes una fuente de datos compartida (por ejemplo, un dataset curado para un grupo de investigación)
  • Quieres sincronización automática sin tener que volver a compartir manualmente

Gestionar bases de datos compartidas ​

Listar comparticiones activas ​

"Muéstrame mis bases de datos compartidas"

Revisar el estado de una compartición ​

El panel de Compartir del Nest muestra todas las comparticiones de bases de datos activas, incluyendo modo, destinatario y hora de la última sincronización.

Revocar acceso ​

Todos los modos de compartición admiten revocación:

  • Clonación — No hay nada que revocar. El destinatario ya tiene una copia.
  • Lectura federada — Detiene de inmediato el acceso a consultas.
  • Suscripción — Detiene las actualizaciones futuras. Los datos ya recibidos se quedan con el suscriptor.

Próximos pasos ​

Bajo el capó ​

Para el formato del paquete de clonación y los detalles internos del protocolo de compartición, consulta la arquitectura del Sharing Server.

Released under the MIT License.