Creación, desarrollo y mantenimiento de cuadernos de Synapse Studio en Azure Synapse AnalyticsCreate, develop, and maintain Synapse Studio notebooks in Azure Synapse Analytics

Un cuaderno de Synapse Studio es una interfaz web para crear archivos que contengan código activo, visualizaciones y texto narrativo.A Synapse Studio notebook is a web interface for you to create files that contain live code, visualizations, and narrative text. Los cuadernos son un buen lugar para validar ideas y aplicar experimentos rápidos para sacar conclusiones a partir de los datos.Notebooks are a good place to validate ideas and use quick experiments to get insights from your data. Los cuadernos también se usan ampliamente en la preparación de datos, la visualización de datos, el aprendizaje automático y otros escenarios de macrodatos.Notebooks are also widely used in data preparation, data visualization, machine learning, and other Big Data scenarios.

Con un cuaderno de Azure Synapse Studio, puede hacer lo siguiente:With an Azure Synapse Studio notebook, you can:

  • Empezar a trabajar sin esfuerzo alguno de configuración.Get started with zero setup effort.
  • Mantener los datos protegidos con las características de seguridad empresarial integradas.Keep data secure with built-in enterprise security features.
  • Analizar datos en formatos sin procesar (CSV, TXT, JSON, etc.), formatos de archivos procesados (parquet, Delta Lake, ORC, etc.) y archivos de datos tabulares de SQL en Spark y SQL.Analyze data across raw formats (CSV, txt, JSON, etc.), processed file formats (parquet, Delta Lake, ORC, etc.), and SQL tabular data files against Spark and SQL.
  • Ser productivo con funcionalidades de creación mejoradas y visualización de datos integrada.Be productive with enhanced authoring capabilities and built-in data visualization.

En este artículo se describe cómo usar los cuadernos en Azure Synapse Studio.This article describes how to use notebooks in Azure Synapse Studio.

Versión preliminar de la nueva experiencia de cuadernoPreview of the new notebook experience

El equipo de Synapse proporciona el nuevo componente de cuaderno en Synapse Studio para ofrecer una experiencia de cuaderno coherente a los clientes de Microsoft y maximizar la capacidad de detección, la productividad, el uso compartido y la colaboración entre usuarios.Synapse team brought the new notebooks component into Synapse Studio to provide consistent notebook experience for Microsoft customers and maximize discoverability, productivity, sharing, and collaboration. La versión preliminar de la nueva experiencia de cuaderno ya está lista.The new notebook experience is ready for preview. En la barra de herramientas del cuaderno, pulse el botón Características de versión preliminar para activar la experiencia.Check the Preview Features button in notebook toolbar to turn it on. En la tabla siguiente se captura la comparación de características entre el cuaderno existente (denominado "cuaderno clásico") y la nueva versión preliminar.The table below captures feature comparison between existing notebook (so called "classical notebook") with the new preview one.

CaracterísticaFeature Cuaderno clásicoClassical Notebook Versión preliminar del cuadernoPreview Notebook
%run%run No compatibleNot supported
%history%history No compatibleNot supported
%load%load No compatibleNot supported
%%html%%html No compatibleNot supported
Arrastrar y colocar para desplazar una celdaDrag and drop to move a cell No compatibleNot supported
Salida del parámetro Display() persistentePersistent Display() output No disponibleNot available
Formato de celdas de texto con botones de la barra de herramientasFormat text cell with toolbar buttons No disponibleNot available
Deshacer la operación de la celdaUndo cell operation No disponibleNot available

Creación de un cuadernoCreate a notebook

Hay dos formas de crear un cuaderno.There are two ways to create a notebook. Puede crear un cuaderno o importar uno existente en un área de trabajo de Azure Synapse desde el Explorador de objetos.You can create a new notebook or import an existing notebook to an Azure Synapse workspace from the Object Explorer. Los cuadernos de Azure Synapse Studio pueden reconocer archivos IPYNB estándar de Jupyter Notebook.Azure Synapse Studio notebooks can recognize standard Jupyter Notebook IPYNB files.

creación de un cuaderno de notas de importación

Desarrollo de cuadernosDevelop notebooks

Los cuadernos se componen de celdas, que son bloques de código individuales o texto que se pueden ejecutar de manera independiente o como grupo.Notebooks consist of cells, which are individual blocks of code or text that can be ran independently or as a group.

Adición de una celdaAdd a cell

Hay varias maneras de agregar una nueva celda a un cuaderno.There are multiple ways to add a new cell to your notebook.

  1. Expanda el botón superior izquierdo + Celda y seleccione Agregar celda de código o Agregar celda de texto.Expand the upper left + Cell button, and select Add code cell or Add text cell.

    add-cell-with-cell-button

  2. Mantenga el puntero sobre el espacio entre dos celdas y seleccione Agregar código o Agregar texto.Hover over the space between two cells and select Add code or Add text.

    add-cell-between-space

  3. Utilice las teclas de método abreviado en el modo de comando.Use Shortcut keys under command mode. Presione A para insertar una celda sobre la celda actual.Press A to insert a cell above the current cell. Presione B para insertar una celda debajo de la celda actual.Press B to insert a cell below the current cell.

Definición del lenguaje principalSet a primary language

Los cuadernos de Azure Synapse Studio admiten cuatro lenguajes de Apache Spark:Azure Synapse Studio notebooks support four Apache Spark languages:

  • pySpark (Python)pySpark (Python)
  • Spark (Scala)Spark (Scala)
  • SparkSQLSparkSQL
  • .NET para Apache Spark (C#).NET for Apache Spark (C#)

Desde la lista desplegable de la barra de comandos superior, puede establecer el lenguaje principal para las nuevas celdas que se agreguen.You can set the primary language for new added cells from the dropdown list in the top command bar.

default-synapse-language

Uso de varios lenguajesUse multiple languages

Para usar varios lenguajes en un cuaderno, puede especificar el comando magic de lenguaje correcto al principio de una celda.You can use multiple languages in one notebook by specifying the correct language magic command at the beginning of a cell. En la tabla siguiente se enumeran los comandos magic para cambiar el lenguaje de las celdas.The following table lists the magic commands to switch cell languages.

Comando magicMagic command IdiomaLanguage DescripciónDescription
%%pyspark%%pyspark PythonPython Ejecute una consulta de Python en SparkContext.Execute a Python query against Spark Context.
%%spark%%spark ScalaScala Ejecute una consulta de Scala en SparkContext.Execute a Scala query against Spark Context.
%%sql%%sql SparkSQLSparkSQL Ejecute una consulta de SparkSQL en SparkContext.Execute a SparkSQL query against Spark Context.
%%csharp%%csharp .NET para Spark C#.NET for Spark C# Ejecute una consulta de .NET para Spark C# en Spark Context.Execute a .NET for Spark C# query against Spark Context.

La imagen siguiente es un ejemplo de cómo se puede escribir una consulta de PySpark con el comando magic %%pyspark o una consulta de SparkSQL con el comando magic %%sql en un cuaderno de Spark (Scala) .The following image is an example of how you can write a PySpark query using the %%pyspark magic command or a SparkSQL query with the %%sql magic command in a Spark(Scala) notebook. Tenga en cuenta que el lenguaje principal del cuaderno está establecido en pySpark.Notice that the primary language for the notebook is set to pySpark.

Comandos magic de Spark de Synapse

<a name="use-temp-tables-to-reference-data-across-languages">Uso de tablas temporales para hacer referencia a datos entre lenguajesUse temp tables to reference data across languages

No puede hacer referencia a datos o variables directamente en distintos lenguajes en un cuaderno de Synapse Studio.You cannot reference data or variables directly across different languages in a Synapse Studio notebook. En Spark, se puede hacer referencia a una tabla temporal entre lenguajes.In Spark, a temporary table can be referenced across languages. Este es un ejemplo de cómo leer un DataFrame de Scala en PySpark y SparkSQL mediante una tabla temporal de Spark como solución alternativa.Here is an example of how to read a Scala DataFrame in PySpark and SparkSQL using a Spark temp table as a workaround.

  1. En la celda 1, lea un DataFrame de un conector de grupo de SQL mediante Scala y cree una tabla temporal.In Cell 1, read a DataFrame from a SQL pool connector using Scala and create a temporary table.

    %%scala
    val scalaDataFrame = spark.read.sqlanalytics(&quot;mySQLPoolDatabase.dbo.mySQLPoolTable")
    scalaDataFrame.createOrReplaceTempView( "mydataframetable" )
    
  2. En la celda 2, consulte los datos mediante Spark SQL.In Cell 2, query the data using Spark SQL.

    %%sql
    SELECT * FROM mydataframetable
    
  3. En la celda 3, use los datos de PySpark.In Cell 3, use the data in PySpark.

    %%pyspark
    myNewPythonDataFrame = spark.sql("SELECT * FROM mydataframetable")
    

IntelliSense de estilo IDEIDE-style IntelliSense

Los cuadernos de Azure Synapse Studio se integran en el editor Monaco para incluir IntelliSense de estilo IDE en el editor de celdas.Azure Synapse Studio notebooks are integrated with the Monaco editor to bring IDE-style IntelliSense to the cell editor. El resaltado de la sintaxis, el marcador de errores y la finalización automática de código le ayudan a escribir código y a identificar problemas más rápido.Syntax highlight, error marker, and automatic code completions help you to write code and identify issues quicker.

Las características de IntelliSense tienen distintos niveles de madurez para distintos lenguajes.The IntelliSense features are at different levels of maturity for different languages. Use la siguiente tabla para ver lo que se admite.Use the following table to see what's supported.

LenguajesLanguages Resaltado de sintaxisSyntax Highlight Creador de errores de sintaxisSyntax Error Marker Finalización de código de sintaxisSyntax Code Completion Finalización de código de sintaxisVariable Code Completion Finalización de código de funciones del sistemaSystem Function Code Completion Finalización de código de funciones del usuarioUser Function Code Completion Sangría inteligenteSmart Indent Plegado de códigoCode Folding
PySpark (Python)PySpark (Python) Yes Yes Yes Yes Yes Yes Yes Yes
Spark (Scala)Spark (Scala) Yes Yes Yes Yes - - - Yes
SparkSQLSparkSQL Yes Yes - - - - - -
.NET para Spark ( C# ).NET for Spark (C#) Yes - - - - - - -

Formato de celdas de texto con botones de la barra de herramientasFormat text cell with toolbar buttons

Puede usar los botones de formato en la barra de herramientas de celdas de texto para completar acciones comunes de marcado.You can use the format buttons in the text cells toolbar to do common markdown actions. Incluye texto en negrita, cursiva, inserción de fragmentos de código, inserción de listas sin ordenar, inserción de listas ordenadas e inserción de imágenes desde direcciones URL.It includes bolding text, italicizing text, inserting code snippets, inserting unordered list, inserting ordered list and inserting image from URL.

Barra de herramientas de celdas de texto de Synapse

Deshacer operaciones en celdasUndo cell operations

Seleccione el botón Deshacer o presione CTRL+Z para revocar la operación más reciente en la celda.Select the undo button or press Ctrl+Z to revoke the most recent cell operation. Ahora puede deshacer hasta las 20 acciones de celda históricas más recientes.Now you can undo up to the latest 20 historical cell actions.

Deshacer celdas en Synapse

Movimiento de una celdaMove a cell

Seleccione los puntos suspensivos (…) para tener acceso al menú de acciones de celda adicionales en el extremo derecho.Select the ellipses (...) to access the additional cell actions menu at the far right. A continuación, seleccione Move cell up (Subir celda) o Move cell down (Bajar celda) para desplazar la celda actual.Then select Move cell up or Move cell down to move the current cell.

También puede utilizar las teclas de método abreviado en el modo de comando.You can also use shortcut keys under command mode. Presione CTRL+Alt+↑ para subir la celda actual.Press Ctrl+Alt+↑ to move up the current cell. Presione CTRL+Alt+↓ para bajar la celda actual.Press Ctrl+Alt+↓ to move the current cell down.

move-a-cell

Eliminación de una celdaDelete a cell

Para eliminar una celda, seleccione los puntos suspensivos (…) para tener acceso al menú de acciones de celda adicionales en el extremo derecho y, a continuación, seleccione Eliminar celda.To delete a cell, select the ellipses (...) to access the additional cell actions menu at the far right then select Delete cell.

También puede utilizar las teclas de método abreviado en el modo de comando.You can also use shortcut keys under command mode. Presione D,D para eliminar la celda actual.Press D,D to delete the current cell.

delete-a-cell

Contracción de una entrada de celdaCollapse a cell input

Seleccione el botón de flecha situado en la parte inferior de la celda actual para contraerla.Select the arrow button at the bottom of the current cell to collapse it. Para expandirla, seleccione el botón de flecha mientras la celda está contraída.To expand it, select the arrow button while the cell is collapsed.

collapse-cell-input

Contracción de una salida de celdaCollapse a cell output

Seleccione el botón Contraer salida situado en la parte superior izquierda de la salida de la celda actual para contraerla.Select the collapse output button at the upper left of the current cell output to collapse it. Para expandirla, haga clic en Mostrar salida de la celda mientras la salida de la celda está contraída.To expand it, select the Show cell output while the cell output is collapsed.

collapse-cell-output

Ejecución de cuadernosRun notebooks

Puede ejecutar las celdas de código en el cuaderno individualmente o todas a la vez.You can run the code cells in your notebook individually or all at once. El estado y el progreso de cada celda se representan en el cuaderno.The status and progress of each cell is represented in the notebook.

Ejecución de una celdaRun a cell

Hay varias maneras de ejecutar el código de una celda.There are several ways to run the code in a cell.

  1. Mantenga el puntero sobre la celda que desea ejecutar y seleccione el botón Ejecutar celda o presione CTRL+Entrar.Hover on the cell you want to run and select the Run Cell button or press Ctrl+Enter.

    run-cell-1

  2. Utilice las teclas de método abreviado en el modo de comando.Use Shortcut keys under command mode. Presione Mayús+Entrar para ejecutar la celda actual y seleccionar la celda a continuación.Press Shift+Enter to run the current cell and select the cell below. Presione Mayús+Entrar para ejecutar la celda actual e insertar una nueva celda a continuación.Press Alt+Enter to run the current cell and insert a new cell below.


Ejecución de todas las celdasRun all cells

Seleccione el botón Ejecutar todo para ejecutar todas las celdas del cuaderno actual en secuencia.Select the Run All button to run all the cells in current notebook in sequence.

run-all-cells

Ejecución de todas las celdas encima o debajoRun all cells above or below

Para tener acceso al menú de acciones de celda adicionales en el extremo derecho, seleccione los puntos suspensivos ( ). A continuación, seleccione Run cells above (Ejecutar las celdas encima) para ejecutar todas las celdas situadas encima de la actual en secuencia.To Access the additional cell actions menu at the far right, select the ellipses (...). Then, select Run cells above to run all the cells above the current in sequence. Seleccione Run cells below (Ejecutar las celdas debajo) para ejecutar todas las celdas situadas debajo de la actual en secuencia.Select Run cells below to run all the cells below the current in sequence.

run-cells-above-or-below

Cancelación de todas las celdas en ejecuciónCancel all running cells

Seleccione el botón Cancelar todo para cancelar las celdas en ejecución o las celdas que esperan en la cola.Select the Cancel All button to cancel the running cells or cells waiting in the queue. cancel-all-cellscancel-all-cells

Referencia del cuadernoNotebook reference

No compatible.Not supported.

Indicador de estado de la celdaCell status indicator

Debajo de la celda se muestra un estado de ejecución detallado de la celda para ayudarle a ver su progreso actual.A step-by-step cell execution status is displayed beneath the cell to help you see its current progress. Una vez que se complete la ejecución de la celda, aparecerá un resumen de la ejecución con la duración total y la hora de finalización; este resumen se mantendrá allí para futuras referencias.Once the cell run is complete, an execution summary with the total duration and end time are shown and kept there for future reference.

cell-status

Indicador de progreso de SparkSpark progress indicator

Un cuaderno de Azure Synapse Studio se basa únicamente en Spark.Azure Synapse Studio notebook is purely Spark based. Las celdas de código se ejecutan en el grupo de Apache Spark sin servidor de manera remota.Code cells are executed on the serverless Apache Spark pool remotely. Aparece un indicador de progreso del trabajo de Spark con una barra de progreso en tiempo real que le ayudará a entender el estado de ejecución del trabajo.A Spark job progress indicator is provided with a real-time progress bar appears to help you understand the job execution status. El número de tareas por cada trabajo o etapa ayuda a identificar el nivel paralelo del trabajo de Spark.The number of tasks per each job or stage help you to identify the parallel level of your spark job. También puede profundizar en la interfaz de usuario de Spark de un trabajo o fase específicos a través de la selección del vínculo del nombre del trabajo o de la fase.You can also drill deeper to the Spark UI of a specific job (or stage) via selecting the link on the job (or stage) name.

spark-progress-indicator

Configuración de la sesión de SparkSpark session config

Puede especificar la duración del tiempo de espera, el número y el tamaño de los ejecutores que se van a dar a la sesión actual de Spark en Configure session (Configurar sesión).You can specify the timeout duration, the number, and the size of executors to give to the current Spark session in Configure session. Reinicie la sesión de Spark para que surtan efecto los cambios de configuración.Restart the Spark session is for configuration changes to take effect. Se borran todas las variables del cuaderno almacenadas en la memoria caché.All cached notebook variables are cleared.

session-managementsession-management

Comando magic de configuración de la sesión de SparkSpark session config magic command

También puede especificar la configuración de la sesión de Spark a través de un comando magic %%configure.You can also specify spark session settings via a magic command %%configure. La sesión de Spark debe reiniciarse para que la configuración surta efecto.The spark session needs to restart to make the settings effect. Se recomienda ejecutar el comando %%configure al principio del cuaderno.We recommend you to run the %%configure at the beginning of your notebook. Recuerde que este es un ejemplo; para obtener una lista completa de parámetros válidos puede consultar https://github.com/cloudera/livy#request-body.Here is a sample, refer to https://github.com/cloudera/livy#request-body for full list of valid parameters

%%configure -f
{
    to config the session.
    "driverMemory":"2g",
    "driverCores":3,
    "executorMemory":"2g",
    "executorCores":2,
    "jars":["myjar1.jar","myjar.jar"],
    "conf":{
        "spark.driver.maxResultSize":"10g"
    }
}

Nota

El comando magic de configuración de la sesión de Spark no se admite en una canalización de Synapse.Spark session config magic command is not supported in Synapse pipeline.

Traslado de los datos a un cuadernoBring data to a notebook

Puede cargar datos desde Azure Blob Storage, Azure Data Lake Store Gen2 y el grupo de SQL, tal como se muestra en los ejemplos de código siguientes.You can load data from Azure Blob Storage, Azure Data Lake Store Gen 2, and SQL pool as shown in the code samples below.

Lectura de un archivo CSV desde Azure Data Lake Store Gen2 como DataFrame de SparkRead a CSV from Azure Data Lake Store Gen2 as a Spark DataFrame

from pyspark.sql import SparkSession
from pyspark.sql.types import *
account_name = "Your account name"
container_name = "Your container name"
relative_path = "Your path"
adls_path = 'abfss://%s@%s.dfs.core.windows.net/%s' % (container_name, account_name, relative_path)

df1 = spark.read.option('header', 'true') \
                .option('delimiter', ',') \
                .csv(adls_path + '/Testfile.csv')

Lectura de un archivo CSV desde Azure Blob Storage como DataFrame de SparkRead a CSV from Azure Blob Storage as a Spark DataFrame


from pyspark.sql import SparkSession

# Azure storage access info
blob_account_name = 'Your account name' # replace with your blob name
blob_container_name = 'Your container name' # replace with your container name
blob_relative_path = 'Your path' # replace with your relative folder path
linked_service_name = 'Your linked service name' # replace with your linked service name

blob_sas_token = mssparkutils.credentials.getConnectionStringOrCreds(linked_service_name)

# Allow SPARK to access from Blob remotely

wasb_path = 'wasbs://%s@%s.blob.core.windows.net/%s' % (blob_container_name, blob_account_name, blob_relative_path)

spark.conf.set('fs.azure.sas.%s.%s.blob.core.windows.net' % (blob_container_name, blob_account_name), blob_sas_token)
print('Remote blob path: ' + wasb_path)

df = spark.read.option("header", "true") \
            .option("delimiter","|") \
            .schema(schema) \
            .csv(wasbs_path)

Lectura de datos desde la cuenta de almacenamiento principalRead data from the primary storage account

Puede tener acceso directamente a los datos de la cuenta de almacenamiento principal.You can access data in the primary storage account directly. No hay necesidad de proporcionar las claves secretas.There's no need to provide the secret keys. En Explorador de datos, haga clic con el botón derecho en un archivo y seleccione Nuevo cuaderno para ver un nuevo cuaderno con el extractor de datos generado automáticamente.In Data Explorer, right-click on a file and select New notebook to see a new notebook with data extractor autogenerated.

data-to-cell

Guardado de cuadernosSave notebooks

Puede guardar un único cuaderno o todos los cuadernos en el área de trabajo.You can save a single notebook or all notebooks in your workspace.

  1. Para guardar los cambios realizados en un solo cuaderno, seleccione el botón Publicar en la barra de comandos del cuaderno.To save changes you made to a single notebook, select the Publish button on the notebook command bar.

    publish-notebook

  2. Para guardar todos los cuadernos en el área de trabajo, seleccione el botón Publicar todo en la barra de comandos del área de trabajo.To save all notebooks in your workspace, select the Publish all button on the workspace command bar.

    publish-all

En las propiedades del cuaderno, puede configurar si incluir la salida de la celda al guardar.In the notebook properties, you can configure whether to include the cell output when saving.

notebook-properties

Comandos magicMagic commands

Puede usar los comandos magic de Jupyter que ya conoce en los cuadernos de Azure Synapse Studio.You can use familiar Jupyter magic commands in Azure Synapse Studio notebooks. Revise la lista siguiente para ver los comandos magic disponibles actualmente.Review the following list as the current available magic commands. Indíquenos sus casos de uso en GitHub para que podamos seguir generando más comandos magic para satisfacer sus necesidades.Tell us your use cases on GitHub so that we can continue to build out more magic commands to meet your needs.

Nota

Solo se admiten los comandos magic siguientes en una canalización de Synapse: %%pyspark, %%spark, %%csharp, %%sql.Only following magic commands are supported in Synapse pipeline : %%pyspark, %%spark, %%csharp, %%sql.

Comandos magic de línea disponibles: %lsmagic, %time, %timeitAvailable line magics: %lsmagic, %time, %timeit

Comandos magic de celda disponibles: %%time, %%timeit, %%capture, %%writefile, %%sql, %%pyspark, %%spark, %%csharp,%%configureAvailable cell magics: %%time, %%timeit, %%capture, %%writefile, %%sql, %%pyspark, %%spark, %%csharp,%%configure

Integración de un cuadernoIntegrate a notebook

Adición de un cuaderno a una canalizaciónAdd a notebook to a pipeline

Seleccione el botón Agregar a la canalización en la esquina superior derecha para agregar un cuaderno a una canalización existente o crear una canalización.Select the Add to pipeline button on the upper right corner to add a notebook to an existing pipeline or create a new pipeline.

Adición de un cuaderno a la canalización

Designación de una celda de parámetrosDesignate a parameters cell

Para parametrizar el cuaderno, seleccione los puntos suspensivos (…) para acceder al menú de acciones de celda adicionales en el extremo derecho.To parameterize your notebook, select the ellipses (...) to access the additional cell actions menu at the far right. A continuación, seleccione Toggle parameter cell (Alternar celda de parámetros) para designar la celda como la celda de parámetros.Then select Toggle parameter cell to designate the cell as the parameters cell.

toggle-parameter

Azure Data Factory busca la celda de parámetros y la trata como valores predeterminados para los parámetros que se pasan en tiempo de ejecución.Azure Data Factory looks for the parameters cell and treats this cell as defaults for the parameters passed in at execution time. El motor de ejecución agregará una nueva celda debajo de la celda de parámetros con parámetros de entrada para sobrescribir los valores predeterminados.The execution engine will add a new cell beneath the parameters cell with input parameters in order to overwrite the default values. Cuando no se designa ninguna celda de parámetros, la celda insertada se insertará en la parte superior del cuaderno.When a parameters cell isn't designated, the injected cell will be inserted at the top of the notebook.

Asignación de valores de parámetros de una canalizaciónAssign parameters values from a pipeline

Una vez que haya creado un cuaderno con parámetros, podrá ejecutarlo desde una canalización con la actividad de cuadernos de Azure Synapse.Once you've created a notebook with parameters, you can execute it from a pipeline with the Azure Synapse Notebook activity. Después de agregar la actividad al lienzo de la canalización, podrá establecer los valores de los parámetros en la sección Parámetros base de la pestaña Configuración.After you add the activity to your pipeline canvas, you will be able to set the parameters values under Base parameters section on the Settings tab.

Asignación de un parámetro

Al asignar valores de parámetros, puede usar el lenguaje de expresiones de canalización o las variables del sistema.When assigning parameter values, you can use the pipeline expression language or system variables.

Teclas de método abreviadoShortcut keys

De forma similar a los cuadernos de Jupyter Notebook, los cuadernos de Azure Synapse Studio tienen una interfaz de usuario modal.Similar to Jupyter Notebooks, Azure Synapse Studio notebooks have a modal user interface. El teclado realiza diferentes acciones en función del modo en que se encuentre la celda del cuaderno.The keyboard does different things depending on which mode the notebook cell is in. Los cuadernos de Synapse Studio admiten los siguientes dos modos para una celda de código determinada: modo de comando y modo de edición.Synapse Studio notebooks support the following two modes for a given code cell: command mode and edit mode.

  1. Una celda se encuentra en modo de comando cuando no hay ningún cursor de texto que le pida que escriba.A cell is in command mode when there is no text cursor prompting you to type. Cuando una celda está en modo de comando, puede editar el cuaderno en su conjunto, pero no escribir en celdas individuales.When a cell is in Command mode, you can edit the notebook as a whole but not type into individual cells. Para ingresar al modo de comando, presione ESC o use el mouse para seleccionar fuera del área del editor de una celda.Enter command mode by pressing ESC or using the mouse to select outside of a cell's editor area.

    command-mode

  2. El modo de edición se indica mediante un cursor de texto que le pide que escriba en el área del editor.Edit mode is indicated by a text cursor prompting you to type in the editor area. Cuando una celda se encuentra en modo de edición, puede escribir en la celda.When a cell is in edit mode, you can type into the cell. Para ingresar al modo de edición, presione Enter o use el mouse para seleccionar en el área del editor de una celda.Enter edit mode by pressing Enter or using the mouse to select on a cell's editor area.

    edit-mode

Teclas de método abreviado en el modo de comandoShortcut keys under command mode

Con los siguientes métodos abreviados de teclado, puede navegar y ejecutar código más fácilmente en cuadernos de Azure Synapse.Using the following keystroke shortcuts, you can more easily navigate and run code in Azure Synapse notebooks.

AcciónAction Accesos directos de cuadernos de Synapse StudioSynapse Studio notebook Shortcuts
Ejecutar la celda actual y seleccionar la que está a continuaciónRun the current cell and select below Mayús+EntrarShift+Enter
Ejecutar la celda actual e insertar una a continuaciónRun the current cell and insert below Alt+EntrarAlt+Enter
Seleccionar la celda anteriorSelect cell above ArribaUp
Seleccionar la celda siguienteSelect cell below BajarDown
Insertar una celda encimaInsert cell above AA
Insertar una celda debajoInsert cell below BB
Extender las celdas seleccionadas encimaExtend selected cells above Mayús+ArribaShift+Up
Extender las celdas seleccionadas debajoExtend selected cells below Mayús+AbajoShift+Down
Subir celdaMove cell up CTRL+Alt+↑Ctrl+Alt+↑
Bajar celdaMove cell down CTRL+Alt+↓Ctrl+Alt+↓
Eliminar celdas seleccionadasDelete selected cells D, DD, D
Cambiar al modo de ediciónSwitch to edit mode EscribaEnter

Teclas de método abreviado en el modo de ediciónShortcut keys under edit mode

Con los siguientes métodos abreviados de teclado, puede navegar y ejecutar código más fácilmente en cuadernos de Azure Synapse en el modo de edición.Using the following keystroke shortcuts, you can more easily navigate and run code in Azure Synapse notebooks when in Edit mode.

AcciónAction Accesos directos de cuadernos de Synapse StudioSynapse Studio notebook shortcuts
Subir el cursorMove cursor up ArribaUp
Bajar el cursorMove cursor down BajarDown
DeshacerUndo CTRL+ZCtrl + Z
RehacerRedo CTRL+YCtrl + Y
Comentar y quitar comentarioComment/Uncomment CTRL+/Ctrl + /
Eliminar palabra anteriorDelete word before CTRL+RetrocesoCtrl + Backspace
Eliminar palabra posteriorDelete word after CTRL+SuprCtrl + Delete
Ir al inicio de la celdaGo to cell start CTRL+InicioCtrl + Home
Ir al final de la celdaGo to cell end CTRL+FinCtrl + End
Ir una palabra a la izquierdaGo one word left CTRL+IzquierdaCtrl + Left
Ir una palabra a la derechaGo one word right CTRL+DerechaCtrl + Right
Seleccionar todoSelect all CTRL+ACtrl + A
Aplicar sangríaIndent Ctrl +]Ctrl +]
Desaplicar sangríaDedent CTRL+[Ctrl + [
Cambiar al modo de comandoSwitch to command mode EscEsc

Pasos siguientesNext steps