Estamos entusiasmados de lanzar un nuevo ecosistema de herramientas para desarrolladores destinado a ayudar a los usuarios avanzados a editar, ejecutar e implementar Question Lambdas desde un entorno de desarrollo native, al mismo tiempo que se integra a la perfección con los sistemas de management de versiones y CI/CD. En este momento, estamos lanzando tres herramientas en una versión beta abierta:
En este weblog, exploraremos las mejores prácticas para usar estas herramientas juntas. Para obtener documentación más detallada sobre el uso de cada herramienta particular person, consulte el LÉAME de cada herramienta. Mire el video a continuación para ver un recorrido detallado de las nuevas herramientas.
Contenido incrustado: https://www.youtube.com/watch?v=WhRueFicCUg&t=2s
Antes de que empieces
Antes de comenzar a utilizar las nuevas herramientas de desarrollo de Rockset, le recomendamos que pruebe lo siguiente desde Rockset Console:
- Configure una cuenta de Rockset en Rockset Console
- Crear un consulta lambda utilizando el Editor de consultas de la consola
- Cree una etiqueta para su Question Lambda
- Ejecute una Question Lambda por etiqueta desde su extremo API o desde uno de nuestros SDK
El flujo de trabajo de alto nivel
Las nuevas herramientas para desarrolladores de Rockset le permiten mover la fuente de la verdad para sus Question Lambdas a su sistema de management de versiones (VCS). También brindan herramientas sólidas para desarrollar Rockset SQL e implementar Question Lambdas en Rockset desde su entorno de desarrollo native.
Recomendamos el siguiente flujo de trabajo de alto nivel para usar las nuevas herramientas de desarrollo. Este flujo de trabajo es muy comparable a los flujos de desarrollo continuo estándar de la industria.
-
Configure un proyecto Rockset native en su código fuente.
a. Inicializa un nuevo proyecto en tu repositorio
b. (CLI) Descargue sus Question Lambdas y regístrelas en el VCS de su elección
-
Desarrolle su Question Lambdas
a. (CLI) Crear/eliminar Question Lambdas
b. (Código VS) Editar consulta Lambdas
C. (UI de desarrollo) Ejecute su Question Lambdas native
d. Iterar
mi. Comprometer y empujar su código
-
Implemente sus Question Lambdas (CI/CD)
a. (CLI) Implemente sus Question Lambdas en Rockset con etiquetas de Question Lambda
- Pulse su Question Lambda desde su aplicación mediante su etiqueta Question Lambda
-
Si es necesario, retroceda sus Question Lambdas
a. (CLI) Vuelva a implementar Question Lambdas asociado con la confirmación etiquetada anterior
Un ejemplo de Hola mundo
0. Instalar las herramientas de desarrollo
Instale la herramienta Rockset CLI. Actualmente, la instalación solo se admite en Linux y MacOS.
# Set up
$ curl https://rockset-cli-artifacts.s3-us-west-2.amazonaws.com/install-standalone.sh | bash
# Restart your terminal to finish set up
# Confirm
$ rockset --version
# Set up CLI autocomplete
$ rockset autocomplete
# Add your authentication data
$ rockset auth:add APIKEY
# Add shell autocomplete help (bash and zsh solely)
$ rockset autocomplete
Puede crear una clave de API en el Consola Rockset. Instale el complemento Rockset VS Code a través del Mercado de código VS. Consulte la documentación de VS Code para obtener más detalles sobre cómo instalar la extensión.
1. Configurar un proyecto
# Navigate to an empty folder
$ cd ~/initiatives/rockset
# Initialize your native undertaking
$ rockset native:init -y
# Add a Question Lambda to your undertaking
$ rockset native:queryLambda:add commons.helloWorld
¡Eso fue fácil! Pero, ¿qué está pasando debajo del capó aquí? Veamos el sistema de archivos y echemos un vistazo más de cerca.
$ tree
.
├── rockset.config.json
└── src
└── commons
├── __sql
│ └── helloWorld.sql
└── helloWorld.lambda.json
Hemos creado 2 archivos: un archivo SQL y un archivo de definición de Question Lambda. El archivo de definición de Lambda incluye información como parámetros predeterminados y la descripción de su Lambda. Puede ver más información sobre estos archivos en la Documentación de CLI.
2. Desarrolle su Question Lambdas
Recomendamos editar su Question Lambdas en VS Code para obtener la mejor experiencia. Para comenzar, abra el directorio raíz de su proyecto (el directorio que contiene rockset.config.json).
Abierto src/commons/__sql/helloWorld.sqly pegue lo siguiente.
SELECT
'Whats up, World' AS "Whats up World"
Si tiene instalada la extensión Rockset SQL, debería ver resaltado de sintaxis completo, así como la función de autocompletar.
También puede ejecutar este SQL directamente en VS Code ejecutando Execute Rockset Question desde la paleta de comandos (Abra la paleta de comandos con Ctrl-Shift-P o Cmd-Shift-P). También puede ejecutar su consulta mediante la CLI.
3. Uso de parámetros
Hagamos que nuestra Question Lambda sea más interesante: ¡agreguemos un parámetro! Vuelva a abrir la fuente de su Lambda y pegue lo siguiente.
SELECT
CONCAT('Whats up ', :title) AS "Whats up World"
Esta consulta ahora lo saludará por su nombre, pero ¿cómo la ejecutamos con parámetros? Para consultas más complejas que incluyen parámetros, recomendamos utilizar la interfaz de usuario de Rockset Developer. Para comenzar, abra la interfaz de usuario del desarrollador usando
$ rockset native:serve -p 3001 # port
Esto debería abrir automáticamente una página internet en su navegador predeterminado. Haga clic en “commons.helloWorld” para ver la página de ejecución de este Lambda.
Página de inicio:
Página de ejecución:
Al hacer clic en el botón ejecutar de esta página, se ejecutará automáticamente el último texto SQL que haya guardado. Pero si hacemos clic en ejecutar ahora mismo, vemos un error: ¡todavía no hemos especificado un valor para el parámetro “nombre”! Para agregar parámetros, haga clic en la pestaña Parámetros. Desde aquí, puede agregar parámetros de ejecución que se pasarán junto con su SQL durante la ejecución. Agregue su nombre como un parámetro llamado “nombre”, con el tipo “cadena”, y ejecute su Lambda.
Agregar parámetros:
Ejecutar con Parámetros:
¡Funciona!
4. Implementación y ejecución de Question Lambdas desde una aplicación
La implementación de Question Lambdas consta de dos pasos. Primero, implementaremos una nueva versión de Question Lambda. Esto agrupa Question Lambda, junto con su configuración, y lo carga en Rockset con un hash de versión. A continuación, etiquetamos nuestro Question Lambda para que podamos consultarlo desde nuestra aplicación.
Al usar Question Lambdas junto con Tags, podemos versionar y actualizar nuestras Question Lambdas sin tener que modificar el código de nuestra aplicación.
# Add new variations, then tag them with the event tag
$ rockset undertaking:deploy -t dev
# Deploy to manufacturing
$ rockset undertaking:deploy -t prod
Efficiently up to date commons.helloWorld — model 061293cecfb67e36
Efficiently tagged commons.helloWorld model 061293cecfb67e36 with tag "prod"
¡Su Question Lambda ahora está disponible y se puede ejecutar desde su aplicación!
Usaremos cURL para probar el punto last. También puede ejecutar una Question Lambda by Tag desde cualquiera de nuestros Language Purchasers o SDK.
# Execute the newly deployed CLI
$ rockset api:queryLambdas:execute commons helloWorld prod
(INFO): POST: /v1/orgs/self/ws/commons/lambdas/helloWorld/tags/prod
También puede encontrar su Question Lambda en el Consola Rockset. Cuando selecciona su Question Lambda, puede ver fragmentos de ejemplo para ejecutar su Question Lambda desde su aplicación en el idioma de su elección.
Conclusión
Estamos increíblemente emocionados de anunciar estas nuevas herramientas. Esperamos que al incorporarlos a su flujo de trabajo le permita
- Compruebe Question Lambdas en el management de versiones
- Desarrolle Question Lambdas en su entorno de desarrollo native
- Administrar la producción Question Lambdas desde CI/CD
¡Feliz hackeo!
