LogoLogo
codatum.comSign InStart for free
  • Introduction
  • Getting Started
    • Quick Start
    • Concept (Further reading)
      • Why did we a choose Block Editor over Cell-based Editor?
  • Connect and Manage Data
    • Connection
      • Sync Table Metadata
    • Supported Warehouses
      • BigQuery
      • Snowflake
      • Other Warehouses
    • Catalog
    • Search
  • Data Exploration
    • Data Exploration Overview
    • Notebook
      • Doc Page
      • Grid Page
      • SQL Block
      • Version
      • Notebook FAQ
    • Chart
    • Explorer
    • Parameter
    • (Appendix) Cache
  • AI Assist
    • SQL Assistant
  • Sharing
    • Sharing Overview
    • Teamspace
    • Shared Notebook
    • Report
    • Public Link
    • Signed Embed
      • How to Set Up Signed Embed
  • Account Management
    • Account
    • Account Settings
  • Workspace & User Management
    • Workspace
  • User Management
    • Invitation
    • Group
  • Security
    • Security Overview
  • Audit logs
  • IP Access Control
  • Access control
    • Access Control Overview
    • Access Control for Workspace
    • Access Control for Resources
      • Access Control for Group
      • Access Control for Teamspace
      • Access Control for Notebook
      • Access Control for Connection
      • Access Control for Report
  • [Under Construction] Plan and Billing
    • Limit and usage
    • Downgrade and cancel
  • Best Practices
    • Advanced Control Structures in SQL
  • Other considerations
    • System requirements
Powered by GitBook

Reference

  • Privacy policy
  • Terms of service
  • JP Docs Site
On this page
  • Summary of Differences in Each Sharing Methods
  • Guidelines for Choosing a Sharing Method

Was this helpful?

  1. Sharing

Sharing Overview

Overview of the methods for sharing Notebooks.

PreviousSQL AssistantNextTeamspace

Last updated 2 months ago

Was this helpful?

Notebook contents can be shared in three ways:

  1. With Team Members: Access Scopes

    • Workspace: Sharing with the entire Workspace

    • : Sharing with the Teamspace

    • : Directly sharing an individual Notebook

  2. With Stakeholders: :

    • Converting the Notebook to a Report that can be accessed by Guests, then sharing the URL or embedding it

  3. With Anonymous Users:

    • Sharing a Public Link to grant access to anyone who knows the link

  4. With Your Application Users: :

    • Integrating the Notebook into your own application with authentication, allowing you to share with your application users

Summary of Differences in Each Sharing Methods

Method
Editable
Query execution
Parameter
Explorer
Embeddable
Guest Access
Required Login
Required Connection Role
Required API Authentication

Access Scopes (Notebook)

Yes

Yes (values shared)

Yes

Report

Selectable

Selectable (values per user)

Selectable

Public Link

No

No

No

Signed Embed

Yes

Yes (values per user)

Selectable

  • Editable: Indicates if users can edit the notebook.

  • Query Execution: Shows whether query execution is possible.

  • Parameter: Indicates whether parameters are enabled and specifies if parameters are shared or user-specific.

  • Embeddable: Determines if content can be embedded in other platforms using HTML iframes.

  • Guest Access: Indicates if guests can access the shared content.

  • Required Login: Shows if login is required to access the content.

  • Required Connection Role: Indicates if connection role referring to SQL Blocks in the notebook is required.

  • Required API Authentication: ...

Guidelines for Choosing a Sharing Method

Choose the appropriate sharing method according to the situation. For example:

Access Scope (Workspace, Teamspace, Shared Notebook):

  • For collaborative editing.

Report:

  • For preventing data from being altered.

  • For improving performance when dealing with large datasets.

  • For focusing on and sharing only specific pages after performing ad-hoc analysis.

  • For sharing with external guests who have no editing permissions and no connection roles.

  • For sharing data analysis results with executives (e.g., CEO) and managers who want only the most important KPIs.

  • When you want to restrict access to the original sensitive data but want to share aggregated results extensively (e.g., internal HR reports).

  • For regularly updating important data for all employees.

    • Note: Even if employees have editing roles for the original Notebook, the list of reports only displays a limited number compared to notebooks, making it easier to filter important ones.

  • For collaborative parameter changes done separately. Additionally, consider using Notebook versions.

Public Link:

  • If you want to embed charts in a blog for marketing purposes or share on Twitter, consider using Public Links.

  • If you want to embed data to be visible only to those with access rights to Notion, consider using Public Links. Additionally, consider using Reports if you want to enforce login.

Signed Embed:

  • For integrating analytics into your own application or product while maintaining control over authentication.

  • For embedding dashboards into internal corporate tools and systems.

  • When building a SaaS product that needs embedded analytics capabilities for your end users.

Teamspace
Shared
Report
Public Link
Signed Embed (Preview)
Syncing Parameter Values and Execution Results Among Users