Lenguaje de interrogaci�n de XAM

As� como el abastecimiento de medios de la vendedor-independiente de crear, recuperando, modificando y suprimiendo XSets, la especificaci�n de SNIA XAM v1.0 tambi�n define un lenguaje de interrogaci�n (XAM QL), basado en un subconjunto de la lengua del SQL, porque de seleccionar y de recuperar el XUIDs de XSets basado en criterios contenido-definidos.

El sistema de las palabras reservadas para este lenguaje de interrogaci�n es absolutamente peque�o: seleccione, donde, y, o, no, como, existe, el atar, inalterable, typeof, longitud, fecha, VERDADES, FALSOS, antes de que, despu�s de, contenga, y dentro. Por dise�o, las preguntas de XAM parecen una declaraci�n selecta del SQL. El lenguaje de interrogaci�n es sin diferenciaci�n entre may�sculas y min�sculas y utiliza el juego de caracteres de ASCII.

Aqu� est� un ejemplo de una pregunta simple de XAM:

select ".xset.xuid" where "com.example.name" = ’Tuckers Plantation'

La versi�n 1.0 de la especificaci�n de XAM define dos niveles de ayuda del lenguaje de interrogaci�n, el nivel 1 es decir del nivel 1 y del nivel 2. define preguntas en caracter�sticas y cualidades de campo en XSets y es obligatorio. Cualquier valor de una propiedad de XSet que sea accesible a un programa de aplicaci�n v�a la biblioteca de XAM puede ser preguntado. El nivel 2 prolonga el nivel 1 a las preguntas de la ayuda en XStreams y es opcional. Ambos niveles de pregunta est�n alcanzados a trav�s de un tipo solo, definido del trabajo que todos los abastecedores de XAM deban apoyar. Puesto que ningún vendedor que soy consciente de tiene preguntas del nivel realmente ejecutado 2, el resto de los focos de este poste en preguntas del nivel 1.

Una instrucci�n del lenguaje de interrogaci�n de XAM consiste en una cl�usula selecta obligatoria seguida por un opcional donde cl�usula. Para XAM v1.0 la �nica cl�usula selecta v�lida es el `selecto .xset.xuid'. Esto especifica que el uso est� pidiendo una lista de valores de XUID. Por ejemplo

select ".xset.xuid "

devolver� una lista de cada XSet que sea legible a la hora de la pregunta.

Donde la cl�usula se utiliza para especificar un subconjunto de XSets que se emparejar�. Para las preguntas del nivel 1 se restringe a las comparaciones entre las caracter�sticas de XSet y los valores y/o las cualidades de campo literales y los valores literales.

select ".xset.xuid" where ".xam.time.xuid" > date(’2009-02-01T00:00:00.0’)

devolver� la lista de todo el Xsets que fueron creadas encendido o despu�s del 1 de febrero de 2009.

Las demostraciones siguientes de la tabla que colocan y los tipos literales pueden ser comparados v�lido.

Las semencias de escape apoyadas son las siguientes. Cualquier otra semencia de escape generar� un error no fatal.

select ".xset.xuid" where "com.example.string-property" = ’This is a string literal’

Para utilizar un ap�strofe en una secuencia, gu�rdela con una barra

select ".xset.xuid" where "com.example.claimed.ownership" = ’Tucker\’s’

Todos los casos de los nombres de campo en una secuencia de la pregunta de XAM se deben cotizar con cotizaciones dobles. Si un nombre de campo contiene caracteres de la cotizaci�n doble, cada car�cter de la cotizaci�n doble se debe escapar usando una barra. Por ejemplo, el nombre de campo para la caracter�stica xam_boolean com.example. el qstring se debe representar en una pregunta como

select ".xam.xuid" where "com.example.\"qstring\"" = TRUE

Si un nombre de campo contiene un car�cter de la barra, la barra s� mismo se debe escapar con otra barra. Por ejemplo, el nombre de campo para la caracter�stica xam_double com.example.file \ cociente se debe representar en una pregunta como

select ".xam.xuid" where "com.example.file\\ratio" = 100.1

El lenguaje de interrogaci�n acepta fecha y hora y los literales XUID-valorados usando las funciones del selector fechan () y xuid () respectivamente. La funci�n de la fecha () toma un valor correctamente formado de la fecha y hora, especificado pues una secuencia literal que sea constante con la especificaci�n de la fecha y hora de XAM.

select ".xset.xuid" where ".xam.time.xuid" = date(’2009-06-01T00:00:00.0’)

La funci�n del xuid () cuenta con un XUID que est� bajo la forma de literal de cadena codificado base64. Un literal de cadena incorrectamente formado genera un error no fatal durante el an�lisis de la pregunta.

Las cualidades de campo est�n alcanzadas usando existen, typeof, inalterable, atascamiento, y las funciones del accessor de la cualidad de campo de la longitud. Existen () las pruebas de funci�n para la existencia de una cualidad de la zona variable (caracter�stica) en un XSet. Eval�a PARA VERDAD si un XSet contiene la zona variable que eval�a de otra manera FALSO.

select ".xset.xuid" where exists("com.example.name")

La funci�n del typeof () vuelve el tipo del MIME de una zona variable en un XSet que sea una caracter�stica secuencia-valorada.

select ".xset.xuid" where typeof("com.example.data") = ’text/plain’
select ".xset.xuid" where typeof("com.example.data") like ’text%’

Esta funci�n puede ser utilizada siempre que un uso podr�a utilizar una referencia del campo a una caracter�stica secuencia-valorada. Observe que las comparaciones con cualquier valor literal de la no-secuencia generan un error no fatal durante el an�lisis de la pregunta.

() La funci�n inalterable eval�a PARA VERDAD cuando un campo en un XSet se marca como inalterable.

select ".xset.xuid" where readonly("com.example.flag")
select ".xset.xuid" where not readonly("com.example.name")

() La funci�n obligatoria eval�a PARA VERDAD cuando un campo en un XSet se marca como atando.

select ".xset.xuid" where binding("com.example.case_id")
select ".xset.xuid" where not binding("com.example.subject")

La funci�n de la longitud () vuelve la longitud, en octetos, de una zona variable.

select ".xset.xuid" where length("com.example.data") > 1024

Cuando est� utilizado en caracter�stica coloca vueltas de esta funci�n la longitud seg�n lo definido para los stypes. Observe que esta funci�n no se debe utilizar para comparar el n�mero de caracteres en una secuencia mientras que esta comparaci�n depende de la codificaci�n del car�cter que es utilizada.

Torneado ahora a los operadores l�gicos. Subclauses dentro del donde la cl�usula puede ser combinada y ser modificada usando a los operadores l�gicos y, o y no. Estos operadores son similares a sus contrapartes del SQL.

Y operador requiere ambos subclauses evaluar PARA VERDAD antes incluyendo un XSet en los resultados. Por ejemplo

select ".xset.xuid" where typeof("com.example.stream") = ’image/gif’ and length("com.example.stream") > 4096

selecciona solamente eso XSets que contiene las im�genes del GIF cuyo tama�o es mayor de 4096 octetos. U operador eval�a PARA VERDAD si cualquier subclause eval�a PARA VERDAD. Por ejemplo

select ".xset.xuid" where typeof("com.example.stream") = ’image/jpeg’ or typeof("com.example.stream") = ’image/gif’

selecciona solamente eso XSets que contiene una corriente nombrada del tipo JPEG o GIF de la imagen. No el operador niega una expresi�n boleana. Por ejemplo

select ".xset.xuid" where not binding("com.example.property")

selecciona todo el XSets con la caracter�stica nonbinding com.example.property.

Como en ciertos operadores del SQL tome la precedencia sobre otros operadores en preguntas. La precedencia de operador de XAM QL es como sigue:

select ".xset.xuid" where not "com.example.bool-prop" and  "com.example.int-prop" = 64
select ".xset.xuid" where not ("com.example.bool-prop" and "com.example.int-prop" = 64)

En el primer ejemplo, no el operador se aplica solamente a la caracter�stica de com.example.bool-prop. En el segundo ejemplo, no el operador se aplica a com.example.bool-prop y a com.example.int-prop = 42.

Ahora que somos algo familiares con sintaxis de XAM QL, la pregunta siguiente que se contestar� es c�mo decimos un sistema del almacenaje de XAM ejecutar una pregunta y volvernos los resultados. Resulta bien que una pregunta est� ejecutada como un tipo particular de trabajo de XAM llam� un trabajo de la pregunta. La entrada a un trabajo de la pregunta es un XSet que usted debe crear. Este XSet debe contener dos art�culos - el mand de org.snia.xam.job.com del campo que se fija siempre al `xam.job.query y a un mand de XStream xam.job.query.com que sea una corriente de texto UTF-8 (tipo texto del MIME del `/llano; charset=utf-8') contener la secuencia real de la expresi�n de la pregunta.

Un trabajo de la pregunta se puede confiar opcionalmente antes o durante de la ejecuci�n del trabajo, pero �ste conf�a no se requiere. La capacidad de confiar un trabajo corriente es dependiente opcional y de la puesta en pr�ctica. Un uso puede determinar si el trabajo conf�a es apoyado comprobando la caracter�stica boleana .xsystem.job.com mit.supported de XSystem. La falta de confiar un trabajo de la pregunta antes de que el cierre del XSet signifique los resultados del trabajo de la pregunta no se almacena persistente.

Un trabajo de la pregunta es ejecutado invocando el submitJob. Si cualquiera de los dos art�culos requeridos en el trabajo XSet de la pregunta no se completa correctamente, el campo est�ndar .xam.job.error del error del trabajo se agrega al trabajo XSet de la pregunta y es valor se fija a cualquier org.snia.xam:: not_a_job u org.snia.xam:: se aborta el unspecified_command y el trabajo de la pregunta. Seg�n las indicaciones del uso de muestra abajo, el estado de un trabajo de la pregunta puede ser determinado examinando el valor de .xam.job.status.

Cuando un trabajo de la pregunta es acertado, los resultados se almacenan en el trabajo XSet de la pregunta bajo la forma de nuevo XStream nombrado xam.job.query.results. Este XStream tiene un tipo del MIME del uso/vnd.snia.xam.query.xuid_list y contiene el XUIDs para el sistema de XSets resultando de la evaluaci�n de la pregunta. Cada XUID se almacena en un formato binario como parte de un expediente de 80 octetos. Si un XUID es m�s corto de 80 octetos, el expediente es cero rellenado a 80 octetos.

Un n�mero de otras caracter�sticas referentes a los resultados XStream tambi�n se fijan. La caracter�stica xam.job.query.results.count del xam_int contiene la cuenta actual de los expedientes de XUID en los resultados XStream. Se pone al d�a esta caracter�stica mientras que los resultados se incorporan en los resultados XStream durante el proceso de la pregunta. Un uso puede utilizar esto para proporcionar la informaci�n de estado a los usuarios mientras que el trabajo de la pregunta ejecuta. La caracter�stica xam_string xam.job.query.level indica el nivel de la pregunta que empareja los resultados. Su valor es u org.snia.xam.job.query.level.1 u org.snia.xam.job.query.level.2.

Es importante recordar que un trabajo de la pregunta funciona dentro de los papeles y de los permisos concedidos a la conexi�n. Eso significa que los resultados XStream incluyen solamente eso XSets que son visibles y accesibles a un uso, por lo menos de una perspectiva le�da, seg�n el papel bajo el cual se ejecuta el trabajo de la pregunta.

El trabajo de la pregunta puede fijar los c�digos de error siguientes en .xam.job.error:

Observe que, desemejante de un RDBMS tradicional, no hay fijaci�n de un sistema del almacenaje de XAM durante la ejecuci�n de un trabajo de la pregunta. As� un resultado de la pregunta no es una foto instant�nea de un sistema del almacenaje de XAM. El contenido de un sistema del almacenaje de XAM puede o no puede cambiar mientras que se ejecuta un trabajo de la pregunta. La regla general es que ningún XSet se haya almacenado que antes de que el comienzo del trabajo de la pregunta se incluya en los resultados XStream si cumple los criterios de la pregunta, y ningún XSet se haya almacenado que despu�s de que el trabajo de la pregunta haya terminado no debe ser incluido en los resultados XStream. XSets que se almacena durante la ejecuci�n de trabajo de la pregunta puede o no puede ser incluido. Los mismos criterios se aplican a los resultados XStream. Puede incluir XUIDs de XSets que est� no m�s en el sistema del almacenaje de XAM y el XUIDs de XSets que cumpla no m�s los criterios de b�squeda debido a un cambio en el XSet despu�s de que el detalle XSet fuera preguntado.

Aqu� est� un uso de Java simple que pregunta un sistema del almacenaje de XAM para determinarlo es nivel de ayuda para las preguntas de XAM.

import org.snia.xam.XAMException;
import org.snia.xam.XAMLibrary;
import org.snia.xam.XSystem;
import org.snia.xam.toolkit.XAMXUID;
import org.snia.xam.util.XAMLibraryFactory;

public class CheckQuerySupport
{
    private static XAMLibrary xamLib;
    private static XSystem xSystem;

    public static void main(String[] args)
    {
        String xri = "snia-xam://centera_vim!XXX.XXXX.XXX.XXX?/home/fpm/xam/xamconnect.pea";

        long exitCode = 0;
        boolean isSupported = false;

        try
        {
            xamLib = XAMLibraryFactory.newXAMLibrary();
            System.out.println("Connecting to XSystem: " + xri + "\n");

            xSystem = xamLib.connect(xri);

            // support job commit?
            isSupported = xSystem.getBoolean(XSystem.XAM_XSYSTEM_JOB_COMMIT_SUPPORTED);
            System.out.println("Support job commit? " + (isSupported ? "Yes" : "No"));

            // support continuance of job?
            isSupported = xSystem.getBoolean(XSystem.XAM_XSYSTEM_JOB_QUERY_CONTINUANCE_SUPPORTED);
            System.out.println("Support job continuance? " + (isSupported ? "Yes" : "No"));

            // support level 1 query?
            isSupported = xSystem.getBoolean(XSystem.XAM_XSYSTEM_JOB_QUERY_LEVEL1_SUPPORTED);
            System.out.println("Support level 1 query? " + (isSupported ? "Yes" : "No"));

            // support level 2 query?
            isSupported = xSystem.getBoolean(XSystem.XAM_XSYSTEM_JOB_QUERY_LEVEL2_SUPPORTED);
            System.out.println("Support level 2 query? " + (isSupported ? "Yes" : "No"));

            xSystem.close();
            System.out.println("\nClosed connection to XSystem");

        } catch (XAMException xe) {
            exitCode = xe.getStatusCode();
            System.err.println("XAM Error occured: " + xe.getMessage());
        } catch (IllegalArgumentException e) {
            System.out.println(e.getMessage());
            e.printStackTrace();
            exitCode = 1;
        }

        System.exit((int) exitCode);
    }
}

Aqu� est� la salida de este uso cuando est� conectada con un sistema del almacenaje del EMC Centera XAM

Connecting to XSystem: snia-xam://centera_vim!XXX.XXX.XXX.XXX?/home/fpm/xam/xamconnect.pea

Support job commit? No
Support job continuance? No
Support level 1 query? Yes
Support level 2 query? No

Closed connection to XSystem

Aqu� est� un uso de Java m�s largo que ejecuta tres la muestra XSets y las preguntas de la muestra que se discutan en la secci�n 10.8 del documento de la arquitectura V1.0 de XAM.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;

import org.snia.xam.XAMException;
import org.snia.xam.XAMLibrary;
import org.snia.xam.XSet;
import org.snia.xam.XStream;
import org.snia.xam.XSystem;
import org.snia.xam.XUID;
import org.snia.xam.toolkit.XAMXUID;
import org.snia.xam.util.XAMLibraryFactory;

public class QueryExample
{
    private static XAMLibrary xamLib;
    private static XSystem xSystem;

    private static void CreateXset(int parm1, String parm2, double parm3)
             throws XAMException
    {
        System.out.print("Create XSet 1 ....  ");

        XSet xSet = xSystem.createXSet(XSet.MODE_UNRESTRICTED);
        xSet.createProperty("com.example.rhc", false, true);
        xSet.createProperty("com,example.foo", false, parm1);
        xSet.createProperty("com.example.bar", false, parm2);
        xSet.createProperty("com.example.num", false, parm3);

        XUID xuID = xSet.commit();
        System.out.println("XUID: " + xuID.toString());

        xSet.close();
    }

   private static void CreateXset(int parm1, int parm2, int parm3)
             throws XAMException
    {
        System.out.print("Create XSet 2 ....  ");

        XSet xSet = xSystem.createXSet(XSet.MODE_UNRESTRICTED);
        xSet.createProperty("com.example.rhc", false, true);
        xSet.createProperty("com,example.foo", false, parm1);
        xSet.createProperty("com.example.bar", false, parm2);
        xSet.createProperty("com.example.num", false, parm3);

        XUID xuID = xSet.commit();
        System.out.println("XUID: " + xuID.toString());

        xSet.close();
    }

    private static void CreateXset(int parm1, int parm2)
             throws XAMException
    {
        System.out.print("Create XSet 3 ....  ");

        XSet xSet = xSystem.createXSet(XSet.MODE_UNRESTRICTED);
        xSet.createProperty("com.example.rhc", false, true);
        xSet.createProperty("com,example.foo", false, parm1);
        xSet.createProperty("com.example.num", false, parm2);

        XUID xuID = xSet.commit();
        System.out.println("XUID: " + xuID.toString());

        xSet.close();
    }

    private static void QueryXsystem(String queryString)
            throws XAMException
    {
        boolean finished = false;
        final int XAM_MAX_XUID = 80;
        int resultCount = 0;
        String status;

        System.out.println("Create query XSet. Query string: " + queryString);

        XSet query = xSystem.createXSet(XSet.MODE_UNRESTRICTED);
        query.createProperty(XSet.XAM_JOB_COMMAND, true, XSet.XAM_JOB_QUERY);

        byte[] buffer = queryString.getBytes();
        XStream queryStream = query.createXStream(XSet.XAM_JOB_QUERY_COMMAND, true, XAMLibrary.TEXT_PLAIN_MIME_TYPE);
        queryStream.write(buffer);
        queryStream.close();

        System.out.println("Submit query job ....");
        query.submitJob();

        System.out.println("Wait for query job to finish ....");

        while (!finished)
        {
            // check  status of query job
            status = query.getString(XSet.XAM_JOB_ERRORHEALTH);
            if (status.equals(XSet.XAM_JOB_ERRORHEALTH_ERROR))
            {
                System.out.println("ERROR: Errorhealth - " + query.getString(XSet.XAM_JOB_ERROR));
                query.haltJob();
                System.out.println("ERROR: Job halted");
                break;
            }

            status = query.getString(XSet.XAM_JOB_STATUS);
            resultCount = (int) query.getLong(XSet.XAM_JOB_QUERY_RESULTS_COUNT);

            // uncomment if you want continuous job status
            // System.out.println("Job Status: " + status + "  Result count: " + resultCount);

            // exit loop if job complete
            if (status.equals(XSet.XAM_JOB_STATUS_COMPLETE))
            {
                finished = true;
            }
       }

        System.out.println("Query job completed ....");
        System.out.println("Result set final count is: " + resultCount);

        if (resultCount > 0)
        {
             // open query job result stream
             XStream results = query.openXStream(XSet.XAM_JOB_QUERY_RESULTS, XStream.MODE_READ_ONLY);

             byte rawXUID[] = new byte[XAM_MAX_XUID];
             long bytesRead = 0;

             // output XUIDs in result set
             while( (bytesRead = results.read(rawXUID, XAM_MAX_XUID)) >= 0 )
             {
                 XAMXUID resultXUID = new XAMXUID(rawXUID);
                 System.out.println("XUID: " + resultXUID.toString());
             }

             results.close();
        }

        query.close();
    }

    public static void main(String[] args)
    {
        String xri = "snia-xam://centera_vim!XXX.XXX.XXX.XXX?/home/fpm/xam/xamconnect.pea";
        long exitCode = 0;

        try
        {
            xamLib = XAMLibraryFactory.newXAMLibrary();

            // uncomment next 2 lines if you want extensive XAM Library logging
            // xamLib.setProperty(XAMLibrary.XAM_LOG_VERBOSITY, 1);
            // xamLib.setProperty(XAMLibrary.XAM_LOG_LEVEL, 5);

            System.out.println("Connecting to XSystem " +  xri + "\n");

            xSystem = xamLib.connect(xri);
            xSystem.setProperty(".xsystem.log.verbosity", 1);
            xSystem.setProperty(".xsystem.log.level", 5);

            CreateXset(1, "string", 123.55);
            CreateXset(77, 42, 100);
            CreateXset(6, 200);

            xSystem.close();

            System.out.println("\nClose/reopen XSystem\n");

            xSystem = xamLib.connect(xri);

            // uncomment one or more of the following queries
            // QueryXsystem("select \".xset.xuid\"");
            QueryXsystem("select \".xset.xuid\" where (\"com.example.foo\" > 0) and (\"com.example.foo\" < 50)");
            // QueryXsystem("select \".xset.xuid\" where (\"com.example.bar\" > 0) and (\"com.example.bar\" < 100)");
            // QueryXsystem("select \".xset.xuid\" where exists (\"com.example.bar\")");
            // QueryXsystem("select \".xset.xuid\" where \"com.example.bar\" like '%ing%'");
            // QueryXsystem("select \".xset.xuid\" where \"com.example.num\" >= 124");
            // QueryXsystem("select \".xset.xuid\" where \"com.example.num\" >= 124.6 ");
            // QueryXsystem("select \".xset.xuid\" where (\"com.example.num\" >= 123) and typeof(\"com.example.num\") = 'application/vnd.snia.xam.int'");

            xSystem.close();
            System.out.println("\nClosed connection to XSystem");

        } catch (XAMException xe) {
            exitCode = xe.getStatusCode();
            System.err.println("XAM Error occured: " + xe.getMessage() + "("
                    + exitCode + ")");
        } catch (IllegalArgumentException e) {
            System.out.println(e.getMessage());
            e.printStackTrace();
            exitCode = -1;
        }

        System.exit((int) exitCode);
    }
}

Observe que los resultados XStream producido por un trabajo de la pregunta se pueden consumir por un uso antes de que el sistema del almacenaje de XAM haya acabado de almacenar todo el XUIDs en los resultados XStream si XStream.asyncRead se utiliza en vez de XStream.read.

Pienso bien que he proporcionado bastante informaci�n y ejemplos para permitirle ir juego con el lenguaje de interrogaci�n de XAM de se. Usted necesita la ayuda yo est� seguro que ser� el grupo del revelador de XAM en los grupos de Google m�s que feliz de ayudarle.

En la partida precisar�a que puesto que los abastecedores del sistema del almacenaje de XAM se requieren actualmente solamente ejecutar la ayuda para las preguntas sobre los meta datos contentos, sospecho que la ayuda para las b�squedas por completo contenido-basadas reales usando XAM puede no ocurrir por alg�n tiempo.