Définition du bloc-notes

Cet article fournit une répartition de la structure de définition pour les éléments de notebook.

Formats pris en charge

Prise en charge FabricGitSource et ipynb formats des éléments de bloc-notes. Si aucun format n’est spécifié, la valeur par défaut FabricGitSourceest .

Remarque

Le FabricGitSource format retourne le contenu du bloc-notes dans le format de fichier correspondant à la langue sélectionnée. Par exemple, si PySpark est sélectionné, le contenu est retourné en tant que .py fichier.

Parties de définition

La définition d’un élément de notebook est constituée d’une seule partie et est construite comme suit :

• Chemin d’accès : nom de fichier, par exemple artifact.content.ipynb.

  • pour PySpark ou Python : notebook-content.py
  • pour Spark SQL : notebook-content.sql
  • pour Spark (Scala) : notebook-content.scala
  • pour SparkR (R) : notebook-content.r

• type de charge utile - InlineBase64

• de charge utile voir : exemple de contenu de charge utile décodé à partir de base64.

Composant plateforme

La partie plateforme est un fichier qui contient les informations de métadonnées du notebook.

• Créer un élément avec une définition respecte le fichier de plateforme s’il est fourni. (Plateforme non obligatoire).

• obtenir la définition d’élément retourne toujours le fichier de plateforme.

• mettre à jour l’élément définition accepte le fichier de plateforme s’il est fourni, mais uniquement si vous définissez un nouveau paramètre d’URL updateMetadata=true.

Exemple de contenu de charge utile au format ipynb décodé à partir de Base64

{
    "nbformat": 4,
    "nbformat_minor": 5,
    "cells": [
        {
            "cell_type": "code",
            "source": ["# Welcome to your new notebook\n# Type here in the cell editor to add code!\n"],
            "execution_count": null,
            "outputs": [],
            "metadata": {}
        }
    ],
    "metadata": {
        "language_info": {
            "name": "python"
        }
    }
}

Exemple de définition pour ipynb

{
    "format": "ipynb",
    "parts": [
        {
            "path": "artifact.content.ipynb",
            "payload": "eyJuYmZvcm1hdCI6NCwibmJmb3JtYXR_fbWlub3IiOjUsImNlbGxzIjpbeyJjZWxsX3R5cGUiOiJjb2RlIiwic291cmNlIjpbIiMgV2VsY29tZSB0byB5b3VyIG5ldyBub3RlYm9va1xuIyBUeXBlIGhlcmUgaW4gdGhlIGNlbGwgZWRpdG9yIHRvIGFkZCBjb2RlIVxuIl0sImV4ZWN1dGlvbl9jb3VudCI6bnVsbCwib3V0cHV0cyI6W10sIm1ldGFkYXRhIjp7fX1dLCJtZXRhZGF0YSI6eyJsYW5ndWFnZV9pbmZvIjp7Im5hbWUiOiJweXRob24ifX19",
            "payloadType": "InlineBase64"
        },
        {
            "path": ".platform",
            "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
            "payloadType": "InlineBase64"
        }
    ]
}

Exemple de contenu de charge utile de format de ressource Git fabric décodé à partir de Base64

# Fabric notebook source 
# METADATA ******************** 
# META { 
# META   "kernel_info": { 
# META     "name": "synapse_pyspark" 
# META   }, 
# META   "dependencies": {} 
# META } 
# CELL ******************** 
# Welcome to your new notebook 
# Type here in the cell editor to add code! 
# METADATA ******************** 
# META { 
# META   "language": "python", 
# META   "language_group": "synapse_pyspark" 
# META } 

Exemple de définition pour fabricGitSource

{
    "format": "fabricGitSource",
    "parts": [
        {
            "path": "notebook-content.py",
            "payload": "ewogICIkc2NoZW1hIjogImh0dHBzOi8vZGV2ZWxvcGVyLm1pY3Jvc29mdC5jb20vanNvbi1zY2hlbWFzL2ZhYnJpYy9naXRJbnRlZ3JhdGlvbi9wbGF0Zm9ybVByb3BlcnRpZXMvMi4wLjAvc2NoZW1hLmpzb24iLAogICJtZXRhZGF0YSI6IHsKICAgICJ0eXBlIjogIk5vdGVib29rIiwKICAgICJkaXNwbGF5TmFtZSI6ICJOb3RlYm9vayA4IiwKICAgICJkZXNjcmlwdGlvbiI6ICJOZXcgbm90ZWJvb2siCiAgfSwKICAiY29uZmlnIjogewogICAgInZlcnNpb24iOiAiMi4wIiwKICAgICJsb2dpY2FsSWQiOiAiMDAwMDAwMDAtMDAwMC0wMDAwLTAwMDAtMDAwMDAwMDAwMDAwIgogIH0KfQ==",
            "payloadType": "InlineBase64"
        },
        {
            "path": ".platform",
            "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
            "payloadType": "InlineBase64"
        }
    ]
}