Añadir una regla de análisis a una tabla configurada - AWS Clean Rooms

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Añadir una regla de análisis a una tabla configurada

En las siguientes secciones se describe cómo añadir una regla de análisis a la tabla configurada. Al definir las reglas de análisis, puede autorizar al miembro que puede realizar consultas a ejecutar consultas que coincidan con una regla de análisis específica admitida en AWS Clean Rooms.

AWS Clean Rooms admite los siguientes tipos de reglas de análisis:

Puede haber una sola regla de análisis por tabla configurada. Puede configurar la regla de análisis en cualquier momento antes de asociar las tablas configuradas a la colaboración.

importante

Si utiliza la computación criptográfica para Clean Rooms y tiene tablas de datos cifrados en la colaboración, la regla de análisis que añada a la tabla configurada cifrada debe ser coherente con la forma en que se cifraron los datos. Por ejemplo, si ha cifrado los datos de SELECT (regla de análisis de agregación), no debe añadir la regla de análisis de JOIN (regla de análisis de listas).

Añadir una regla de análisis de agregación a una tabla (flujo guiado)

La regla de análisis de agregación permite realizar consultas que agreguen estadísticas sin revelar información a nivel de fila utilizando COUNTSUM, y AVG funciona según dimensiones opcionales.

Este procedimiento describe el proceso de añadir una regla de análisis de agregación a la tabla configurada mediante la opción Flujo guiado de la consola de AWS Clean Rooms .

Para añadir la regla de análisis de agregación a una tabla (flujo guiado)
  1. Inicia sesión en la AWS Clean Rooms consola AWS Management Console y ábrela con tu Cuenta de AWS (si aún no lo has hecho).

  2. En el panel de navegación izquierdo, elija Tablas configuradas.

  3. Seleccione la tabla configurada.

  4. En la página de detalles de la tabla configurada, seleccione Configurar regla de análisis.

  5. En Paso 1: Elegir el tipo, en Tipo, deje la opción Agregación seleccionada, tal como aparece de forma predeterminada.

  6. En Método de creación, seleccione Flujo guiado y, a continuación, seleccione Siguiente.

  7. En Paso 2: Especificar controles de consulta, en Funciones de agregación:

    1. Elija una Función de agregación en el menú desplegable:

      • COUNT

      • COUNT DISTINCT

      • SUM

      • SUM DISTINCT

      • AVG

    2. Elija qué columnas se pueden usar en la Función de agregación en el menú desplegable Columnas.

    3. (Opcional) Seleccione Añadir otra función para añadir otra función de agregación y asociar una o más columnas a esa función.

      nota

      Se requiere al menos una función de agregación.

    4. (Opcional) Seleccione Eliminar para eliminar una función de agregación.

  8. En Controles de combinación,

    1. Seleccione una opción para Permitir que la tabla se consulte por sí misma:

      Si selecciona... Entonces...
      No, solo se puede consultar el solapamiento La tabla solo se puede consultar si está combinada con una tabla propiedad del miembro que puede realizar consultas.
      La tabla se puede consultar por sí misma o cuando se combina con otras tablas.
    2. En Especificar columnas de combinación, seleccione las columnas que desea permitir que se utilicen en la instrucción INNER JOIN.

      Esto es opcional si ha seleccionado en el paso anterior.

    3. En Especificar operadores permitidos para la coincidencia, elija qué operadores (si los hay) se pueden usar para hacer coincidir varias columnas de combinación. Si selecciona dos o más columnas JOIN, será obligatorio el uso de uno de estos operadores.

      Si selecciona... Entonces...
      AND Puede incluir AND en las condiciones de coincidencia INNER JOIN para combinar una columna con otra entre tablas.
      OR Puede incluir OR en las condiciones de coincidencia INNER JOIN para combinar varias coincidencias de columna entre tablas. Este operador lógico es útil para obtener una tasa de coincidencia más alta.
  9. (Opcional) Para los controles de dimensiones, en el menú desplegable Especificar columnas de dimensiones, elija qué columnas quiere permitir que se usen en la SELECT declaración y las ORDER BY partes WHERE GROUPBY, y de la consulta.

    nota

    No se pueden usar columnas de combinación ni de función de agregación como columnas de dimensión.

  10. En Funciones escalares, seleccione una opción para ¿Qué funciones escalares desea permitir?

    Si selecciona... Entonces...
    Todas ellas son compatibles actualmente con AWS Clean Rooms Se permiten todas las funciones escalares actualmente admitidas por AWS Clean Rooms.
    • Puede seleccionar Ver lista para ver la lista completa de Funciones escalares admitidas en AWS Clean Rooms.

    Una lista personalizada Puede personalizar las funciones escalares que desea permitir.
    • Elija una o más opciones del menú desplegable Especificar las funciones escalares permitidas.

    Ninguna No se permite ninguna función escalar.

    Para obtener más información, consulte Funciones escalares.

  11. Seleccione Siguiente.

  12. En Paso 3: Especificar controles de resultados de consulta, en Restricciones de agregación:

    1. Seleccione cada Nombre de columna en la lista desplegable.

    2. Seleccione en la lista desplegable cada Número mínimo de valores diferenciados que se debe cumplir para que se devuelva cada fila de salida después de aplicarle la función COUNT DISTINCT.

    3. Seleccione Añadir restricción para añadir más restricciones de agregación.

    4. (Opcional) Seleccione Eliminar para eliminar una restricción de agregación.

  13. Para aplicar análisis adicionales a los resultados, seleccione una opción en función de su objetivo.

    ¿Tu objetivo Opción recomendada
    Permitir solo consultas directas en esta tabla. Impida que se ejecuten análisis adicionales en los resultados de las consultas. La tabla solo se puede utilizar para consultas directas. No está permitido
    Permita, pero no exija, tanto las consultas directas como los análisis adicionales en esta tabla. Permitido
    Exija que la tabla solo se pueda utilizar en consultas directas que se procesen con uno de los análisis adicionales necesarios. Las consultas directas de esta tabla deben procesarse más a fondo antes de poder devolverse. Obligatorio
  14. Elija Next (Siguiente).

  15. En Paso 4: Revisar y configurar, revise las selecciones que realizó en los pasos anteriores, edítelas si es necesario y, a continuación, seleccione Configurar regla de análisis.

Verá un mensaje de confirmación en el que se indica que ha configurado correctamente una regla de análisis de agregación en la tabla.

Añadir una regla de análisis de listas a una tabla (flujo guiado)

La regla de análisis de listas permite realizar consultas que generen listas a nivel de fila del solapamiento entre la tabla asociada y la tabla del miembro que puede realizar la consulta.

Este procedimiento describe el proceso de agregar la regla de análisis de listas a la tabla configurada mediante la opción de flujo guiado de la AWS Clean Rooms consola.

Para añadir una regla de análisis de lista a una tabla (flujo guiado)
  1. Inicie sesión en la AWS Clean Rooms consola AWS Management Console y ábrala con su Cuenta de AWS (si aún no lo ha hecho).

  2. En el panel de navegación izquierdo, elija Tablas configuradas.

  3. Seleccione la tabla configurada.

  4. En la página de detalles de la tabla configurada, seleccione Configurar regla de análisis.

  5. En Paso 1: Elegir tipo, en Tipo, seleccione la opción Lista.

  6. En Método de creación, seleccione Flujo guiado y, a continuación, seleccione Siguiente.

  7. En Paso 2: Especificar controles de consulta, en Controles de combinación:

    1. En Especificar columnas de combinación, seleccione las columnas que desea permitir que se utilicen en la instrucción INNER JOIN.

    2. En Especificar operadores permitidos para la coincidencia, elija qué operadores (si los hay) se pueden usar para hacer coincidir varias columnas de combinación. Si selecciona dos o más columnas JOIN, será obligatorio el uso de uno de estos operadores.

      Si selecciona... Entonces...
      AND Puede incluir AND en las condiciones de coincidencia INNER JOIN para combinar una columna con otra entre tablas.
      OR Puede incluir OR en las condiciones de coincidencia INNER JOIN para combinar varias coincidencias de columna entre tablas. Este operador lógico es útil para obtener una tasa de coincidencia más alta.
  8. (Opcional) En Controles de lista, en el menú desplegable Especificar columnas de la lista, seleccione las columnas que desea permitir que se utilicen en el resultado de la consulta (es decir, que se usen en la instrucción SELECT) o que se usen para filtrar los resultados (es decir, en la instrucción WHERE).

  9. Elija Next (Siguiente).

  10. En el paso 3: Especificar los controles de los resultados de la consulta, si desea aplicar análisis adicionales a los resultados, seleccione una opción en función de su objetivo.

    ¿Tu objetivo Opción recomendada
    Permitir solo consultas directas en esta tabla. Impida que se ejecuten análisis adicionales en los resultados de las consultas. La tabla solo se puede utilizar para consultas directas. No está permitido
    Permita, pero no exija, tanto las consultas directas como los análisis adicionales en esta tabla. Permitido
    Exija que la tabla solo se pueda utilizar en consultas directas que se procesen con uno de los análisis adicionales necesarios. Las consultas directas de esta tabla deben procesarse más a fondo antes de poder devolverse. Obligatorio
  11. En Paso 4: Revisar y configurar, revise las selecciones que realizó en los pasos anteriores, edítelas si es necesario y, a continuación, seleccione Configurar regla de análisis.

Verá un mensaje de confirmación en el que se indica que ha configurado correctamente una regla de análisis de lista en la tabla.

Añadir una regla de análisis personalizada a una tabla (flujo guiado)

La regla de análisis personalizada permite realizar SQL consultas personalizadas en una tabla configurada. La regla de análisis personalizada es obligatoria si utiliza:

  • plantillas de análisis: para permitir un conjunto específico de SQL consultas previamente aprobadas o un conjunto específico de cuentas que puedan realizar consultas que utilicen sus datos

  • privacidad diferencial: para proteger a los usuarios de los intentos de identificación

Este procedimiento describe el proceso de agregar la regla de análisis personalizada a la tabla configurada mediante la opción de flujo guiado de la AWS Clean Rooms consola.

Para añadir una regla de análisis personalizada a una tabla (flujo guiado)
  1. Inicie sesión en la AWS Clean Rooms consola AWS Management Console y ábrala con su Cuenta de AWS (si aún no lo ha hecho).

  2. En el panel de navegación izquierdo, elija Tablas configuradas.

  3. Seleccione la tabla configurada.

  4. En la página de detalles de la tabla configurada, seleccione Configurar regla de análisis.

  5. En Paso 1: Elegir tipo, en Tipo, seleccione la opción Personalizada.

  6. En Método de creación, seleccione Flujo guiado y, a continuación, seleccione Siguiente.

  7. En el Paso 2: Configuración de la privacidad diferencial, determine si desea activar o desactivar la privacidad diferencial. La privacidad diferencial es una técnica probada matemáticamente para proteger sus datos de los ataques de reidentificación.

    1. Para una privacidad diferencial:

      Si... Entonces seleccione...
      Tiene datos en el nivel de usuario y desea protegerse contra los intentos de reidentificación Activar
      No tienes datos a nivel de usuario o no necesitas protección contra los intentos de reidentificación Desactivar
    2. Si has elegido activar la privacidad diferencial, selecciona la columna del identificador de usuario que contiene el identificador único de tus usuarios, como la user_id columna cuya privacidad quieres proteger.

      Para activar la privacidad diferencial en dos o más tablas de una colaboración, debe configurar la misma columna que la columna del identificador de usuario en ambas reglas de análisis para mantener una definición coherente de los usuarios en todas las tablas. Si la configuración es incorrecta, el miembro que puede realizar la consulta recibe un mensaje de error que indica que hay dos columnas entre las que elegir para calcular el número de contribuciones de los usuarios (por ejemplo, el número de impresiones de anuncios realizadas por un usuario) al ejecutar la consulta.

    3. Elija Next (Siguiente).

  8. En Paso 3: Especificar controles de consulta,

    1. En el tipo de control, elija una opción en función de su objetivo.

      ¿Tu objetivo Opción
      Revisar cada nueva plantilla de análisis antes de ejecutarla en la tabla configurada Revisar cada nuevo análisis antes de permitir que se ejecute en esta tabla
      Permitir que se ejecute cualquier plantilla de análisis o consulta directa en la tabla configurada Permitir que cualquier consulta creada por determinados colaboradores se ejecute sin revisión en esta tabla
    2. Seleccione una de las siguientes opciones:

      Si ha seleccionado... Entonces...
      Revisar cada nuevo análisis antes de permitir que se ejecute en esta tabla En Plantillas de análisis que se pueden ejecutar, seleccione Añadir plantilla de análisis y, a continuación, seleccione la Colaboración y la Plantilla de análisis que corresponda en las listas desplegables.
      Permitir que cualquier consulta creada por determinados colaboradores se ejecute sin revisión en esta tabla En Cuentas de AWS Permitido crear cualquier consulta, selecciona Añadir y Cuenta de AWS, a continuación, elige el Cuenta de AWS ID correspondiente.
  9. Elija Next (Siguiente).

  10. En el paso 4: especifique los controles de los resultados de la consulta,

    1. En el caso de las columnas que no se permiten en la salida, elige una opción en función de tu objetivo.

      ¿Tu objetivo Opción recomendada
      Permita que se devuelvan todas las columnas en los resultados de las consultas Ninguna
      Impedir que se devuelvan determinadas columnas en los resultados de las consultas Lista personalizada
    2. Seleccione una de las siguientes opciones:

      Si ha seleccionado... Entonces...
      Ninguna Continúe con los análisis adicionales aplicados a los resultados
      Lista personalizada En Especificar columnas no permitidas, elija las columnas que desee eliminar de los resultados de la consulta.
    3. Para aplicar análisis adicionales a los resultados, seleccione una opción en función de su objetivo.

      ¿Tu objetivo Opción recomendada
      Permitir solo consultas directas en esta tabla. Impida que se ejecuten análisis adicionales en los resultados de las consultas. La tabla solo se puede utilizar para consultas directas. No está permitido
      Permita, pero no exija, tanto las consultas directas como los análisis adicionales en esta tabla. Permitir
      Exija que la tabla solo se pueda utilizar en consultas directas que se procesen con uno de los análisis adicionales necesarios. Las consultas directas de esta tabla deben procesarse más a fondo antes de poder devolverse. Obligatorio
  11. Elija Next (Siguiente).

  12. En el paso 5: Revisar y configurar, revise las selecciones que realizó en los pasos anteriores, edítelas si es necesario y, a continuación, elija Configurar la regla de análisis.

Ve un mensaje de confirmación en el que se indica que ha configurado correctamente una regla de análisis personalizada en la tabla.

Añadir una regla de análisis a una tabla (JSONeditor)

El siguiente procedimiento muestra cómo añadir una regla de análisis a una tabla mediante la opción de JSONeditor de la AWS Clean Rooms consola.

Para añadir una regla de agregación, lista o análisis personalizada a una tabla (JSONeditor)
  1. Inicie sesión en AWS Management Console y abra la AWS Clean Rooms consola con su Cuenta de AWS (si aún no lo ha hecho).

  2. En el panel de navegación izquierdo, elija Tablas configuradas.

  3. Seleccione la tabla configurada.

  4. En la página de detalles de la tabla configurada, seleccione Configurar regla de análisis.

  5. En Paso 1: Elegir tipo, en Tipo, seleccione la opción Agregación, Lista o Personalizada.

  6. En Método de creación, selecciona JSONeditor y, a continuación, selecciona Siguiente.

  7. En Paso 2: Especificar controles, puede optar por insertar una estructura de consulta (Insertar plantilla) o insertar un archivo (Importar desde archivo).

    Si selecciona... Entonces...
    Insertar plantilla
    1. Especifique los parámetros de la regla de análisis seleccionada en Definición de la regla de análisis.

    2. Puede pulsar Ctrl + barra espaciadora para habilitar la función de autocompletar.

    Para obtener más información acerca de los parámetros de la regla de análisis de agregación, consulte Regla de análisis de agregación: controles de consulta.

    Para obtener más información acerca de los parámetros de la regla de análisis de lista, consulte Regla de análisis de lista: controles de consulta.

    Importar desde archivo
    1. Selecciona JSON el archivo de tu unidad local.

    2. Elija Open.

      La Definición de la regla de análisis muestra la regla de análisis del archivo cargado.

  8. Elija Next (Siguiente).

  9. En Paso 3: Revisar y configurar, revise las selecciones que realizó en los pasos anteriores, edítelas si es necesario y, a continuación, seleccione Configurar regla de análisis.

Recibe un mensaje de confirmación en el que se indica que ha configurado correctamente una regla de análisis en la tabla.

Siguientes pasos

Ahora que ha configurado una regla de análisis para la tabla configurada, ya puede: