Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.prophecy.ai/llms.txt

Use this file to discover all available pages before exploring further.

MongoDB is a NoSQL database designed to store and retrieve unstructured or semi-structured data using BSON documents.

​
Prerequisites

When you create a MongoDB connection in Prophecy, access permissions are tied to the credentials you use. This is because Prophecy uses your credentials to execute all data operations, such as reading from or writing to collections. To fully leverage a MongoDB connection in Prophecy, you need the following MongoDB permissions:
  • Read from the collection defined in the connection
  • Write to the collection defined in the connection

​
Feature support

The table below outlines whether the connection supports certain Prophecy features.
FeatureSupported
Read data with a Source gemYes
Write data with a Target gemYes
Browse data in the Environment browserYes
Index tables in the Knowledge GraphNo

​
Connection parameters

To create a connection with MongoDB, enter the following parameters:
ParameterDescription
Connection NameName to identify your connection
ProtocolProtocol to use to communicate to the database
Example:mongodb+srv for cloud-hosted clusters
HostWhere your MongoDB instance runs
Example:cluster0.<cluster-name>.mongodb.net for cloud-hosted clusters
UsernameUsername for your MongoDB instance
Password (Secret required)Password for your MongoDB instance
DatabaseDefault database for reading and writing data
CollectionCollection to use for the connection

​
Data type mapping

When Prophecy processes data from MongoDB using SQL warehouses, it converts MongoDB-specific data types to formats compatible with your target warehouse. This table shows how MongoDB data types are transformed for Databricks, BigQuery, and Snowflake.
MongoDBDatabricksBigQuerySnowflake
32-bit integerint
Alias: Integer		int64
Alias: Integer		number
Alias: Number
64-bit integerbigint
Alias: Bigint		int64
Alias: Integer		number
Alias: Number
Doubledouble
Alias: Double		float64
Alias: Float		float
Alias: Float
Booleanboolean
Alias: Boolean		bool
Alias: Boolean		boolean
Alias: Boolean
Stringstring
Alias: String		string
Alias: String		string
Alias: String
Datetimestamp
Alias: Timestamp		timestamp
Alias: Timestamp		timestamp
Alias: Timestamp
Timestamptimestamp
Alias: Timestamp		timestamp
Alias: Timestamp		timestamp
Alias: Timestamp
Binarybinary
Alias: Binary		bytes
Alias: Bytes		binary
Alias: Binary
ObjectIdstring
Alias: String		string
Alias: String		string
Alias: String
Decimal128decimal(34,2)
Alias: Decimal		bignumeric(34,2)
Alias: Numeric		number(34,2)
Alias: Number
Min keystring
Alias: String		string
Alias: String		string
Alias: String
Max keystring
Alias: String		string
Alias: String		string
Alias: String
Regular Expressionstring
Alias: String		string
Alias: String		string
Alias: String
DBPointerstring
Alias: String		string
Alias: String		string
Alias: String
JavaScriptstring
Alias: String		string
Alias: String		string
Alias: String
JavaScript with scopestring
Alias: String		string
Alias: String		string
Alias: String
Symbolstring
Alias: String		string
Alias: String		string
Alias: String
Embedded Documentstruct
Alias: Struct		struct
Alias: Struct		variant
Alias: Variant
Arrayarray
Alias: Array		array
Alias: Array		array
Alias: Array
Empty Arrayarray
Alias: Array		array
Alias: Array		array
Alias: Array
Nullstring
Alias: String		string
Alias: String		string
Alias: String
Unidentifiedstring
Alias: String		string
Alias: String		string
Alias: String
Embedded MongoDB documents are inferred as Snowflake VARIANT values when read through the Spark MongoDB connector. Although Snowflake supports the OBJECT type, inferred embedded documents map to VARIANT unless explicitly declared otherwise.
Learn more in Supported data types.

​
Sharing connections within teams

Connections in Prophecy are stored within fabrics, which are assigned to specific teams. Once a MongoDB connection is added to a fabric, all team members who have access to the fabric can use the connection in their projects. No additional authentication is required—team members automatically inherit the access and permissions of the stored connection credentials.
Be mindful of the access level granted by the stored credentials. Anyone on the team will have the same permissions—including access to sensitive data if allowed.To manage this securely, consider creating a dedicated fabric and team for high-sensitivity connections. This way, only approved users have access to those credentials.