Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Funktionen

Verwenden Sie die folgenden integrierten Funktionen in den SELECT- oder WHERE-Klauseln Ihrer SQL-Ausdrücke.

abs(Decimal)

Gibt den absoluten Wert einer Zahl zurück. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: abs(-5) gibt 5 zurück.

accountid()

Gibt die ID des Kontos zurück, das diese Regel als String besitzt. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel:

accountid() = "123456789012"

acos(Decimal)

Gibt den umgekehrten Kosinus einer Zahl im Bogenmaß zurück. Decimal-Argumente werden vor dem Anwenden der Funktion auf doppelte Genauigkeit gerundet. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: acos(0) = 1,5707963267948966

asin(Decimal)

Gibt den umgekehrten Sinus einer Zahl im Bogenmaß zurück. Decimal-Argumente werden vor dem Anwenden der Funktion auf doppelte Genauigkeit gerundet. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: asin(0) = 0,0

atan(Decimal)

Gibt den umgekehrten Tangens einer Zahl im Bogenmaß zurück. Decimal-Argumente werden vor Anwendung des Features auf doppelte Genauigkeit gerundet. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: atan(0) = 0,0

atan2(Decimal, Decimal)

Gibt den Winkel im Bogenmaß zwischen der positiven x-Achse und dem Punkt (x, y) an, der in den beiden Argumenten definiert ist.  Der Winkel ist positiv für Winkel gegen den Uhrzeigersinn (obere Halbebene, y > 0) und negativ für Winkel im Uhrzeigersinn (untere Halbebene, y < 0). Decimal Argumente werden vor dem Anwenden der Funktion auf doppelte Genauigkeit gerundet. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: atan2(1, 0) = 1,5707963267948966

aws_lambda(functionArn, inputJson)

Ruft die angegebene Lambda-Funktion. Dabei wird inputJson an die Lambda-Funktion übergeben und das von der Lambda-Funktion generierte JSON-Objekt zurückgegeben.

Sie müssen AWS IoT lambda:InvokeFunction Berechtigungen erteilen, um die angegebene Lambda-Funktion aufzurufen. Das folgende Beispiel zeigt, wie die lambda:InvokeFunction-Berechtigung mit AWS CLI erteilt wird:

aws lambda add-permission --function-name "function_name"
--region "region"
--principal iot.amazonaws.com 
--source-arn arn:aws:iot:us-east-1:account_id:rule/rule_name
--source-account "account_id"
--statement-id "unique_id" 
--action "lambda:InvokeFunction"

Im Folgenden werden die Argumente für den Befehl add-permission aufgeführt:

Bei einer JSON-Nachrichtennutzlast wie:

{
    "attribute1": 21,
    "attribute2": "value"
}

Die aws_lambda-Funktion kann verwendet werden, um die Lambda-Funktion wie folgt aufzurufen.

SELECT
aws_lambda("arn:aws:lambda:us-east-1:account_id:function:lambda_function", {"payload":attribute1}) as output FROM 'topic-filter'

Wenn Sie möchten, dass die vollständige MQTT-Nachrichtnutzlast übergeben wird, können Sie die JSON-Nutzlast mit „*“ angeben.

SELECT
aws_lambda("arn:aws:lambda:us-east-1:account_id:function:lambda_function", *) as output FROM 'topic-filter'

payload.inner.element wählt Daten von der zu Thema „Thema/Unterthema” veröffentlichten Nachrichten aus.

some.value wählt Daten aus der Ausgabe aus, die von der Lambda Funktion generiert wurde.

bitand(Int, Int)

Führt Bit für Bit AND für die Bit-Darstellungen der beiden Int(-konvertierten) Argumente durch. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: bitand(13, 5) = 5

bitor(Int, Int)

Führt eine bBit für Bit einen OR-Vorgang für die Bit-Darstellungen der beiden Argumente durch. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: bitor(8, 5) = 13

bitxor(Int, Int)

Führt Bit für Bit eine XOR-Maßnahme für die Bit-Darstellungen der beiden Int(-konvertierten) Argumente durch. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: bitor(13, 5) = 8

bitnot(Int)

Führt Bit für Bit einen NOT-Vorgang für die Bit-Darstellungen des Int(-konvertierten) Arguments durch. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: bitnot(13) = 2

cast()

Konvertiert einen Wert von einem Datentyp in einen anderen. Diese Umwandlung verhält sich größtenteils wie die Standardkonvertierungen. Zusätzlich verfügt sie jedoch über die Möglichkeit, Zahlen von oder zu booleschen Werten umzuwandeln. Wenn Sie AWS IoT nicht feststellen können, wie ein Typ in einen anderen umgewandelt werden soll, lautet das Ergebnis. Undefined Unterstützt von SQL Version 2015-10-08 und höher. Format: cast(value as type).

Beispiel:

cast(true as Int) = 1

Die folgenden Schlüsselwörter können beim Aufrufen von cast unter Umständen nach „as“ angezeigt werden:

Umwandlungsregeln:

ceil(Decimal)

Rundet den angegebenen Decimal-Wert auf den nächsten Int-Wert auf. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiele:

ceil(1.2) = 2

ceil(-1.2) = -1

chr(String)

Gibt das ASCII-Zeichen zurück, das dem angegebenen Int-Argument entspricht. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiele:

chr(65) = "A".

chr(49) = "1".

clientid()

Gibt die ID des MQTT-Clients zurück, der die Nachricht sendet, oder n/a, wenn die Nachricht nicht über MQTT gesendet wurde. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel:

clientid() = "123456789012"

concat()

Hängt Arrays oder Zeichenfolgen aneinander an. Diese Funktion akzeptiert eine beliebige Anzahl von Argumenten und gibt einen – Stringoder Array-Wert zurück. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiele:

concat() = Undefined.

concat(1) = "1".

concat([1, 2, 3], 4) = [1, 2, 3, 4].

concat([1, 2, 3], "hello") = [1, 2, 3, "hello"]

concat("con", "cat") = "concat"

concat(1, "hello") = "1hello"

concat("he","is","man") = "heisman"

concat([1, 2, 3], "hello", [4, 5, 6]) = [1, 2, 3, "hello", 4, 5, 6]

cos(Decimal)

Gibt den Kosinus einer Zahl im Bogenmaß zurück. Decimal-Argumente werden vor dem Anwenden der Funktion auf doppelte Genauigkeit gerundet. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel:

cos(0) = 1.

cosh(Decimal)

Gibt den hyperbolischen Kosinus einer Zahl im Bogenmaß zurück. Decimal-Argumente werden vor dem Anwenden der Funktion auf doppelte Genauigkeit gerundet. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: cosh(2.3) = 5,037220649268761.

decode(value, decodingScheme)

Verwenden Sie die decode Funktion, um einen kodierten Wert zu dekodieren. Wenn es sich bei der dekodierten Zeichenfolge um ein JSON-Dokument handelt, wird ein adressierbares Objekt zurückgegeben. Andernfalls wird die dekodierte Zeichenfolge als Zeichenfolge zurückgegeben. Die Funktion gibt NULL zurück, wenn die Zeichenfolge nicht dekodiert werden kann. Diese Funktion unterstützt die Dekodierung von Base64-kodierten Zeichenketten und das Nachrichtenformat Protocol Buffer (protobuf).

Unterstützt von der SQL Version vom 23.03.2016 und höher.

Dekodierung von base64-verschlüsselten Strings

In diesem Beispiel enthält die Nachrichtennutzlast einen kodierten Wert.

{
    encoded_temp: "eyAidGVtcGVyYXR1cmUiOiAzMyB9Cg=="
}

Die decode-Funktion in dieser SQL-Anweisung dekodiert den Wert in der Nachrichtennutzlast.

SELECT decode(encoded_temp,"base64").temperature AS temp from 'topic/subtopic'

Die Dekodierung des encoded_temp-Wertes führt zu dem folgenden gültigen JSON-Dokument, das es der SELECT-Anweisung ermöglicht, den Temperaturwert zu lesen.

{ "temperature": 33 }

Das Ergebnis der SELECT-Anweisung in diesem Beispiel wird hier gezeigt.

{ "temp": 33 }

Ist der dekodierte Wert kein gültiges JSON-Dokument, wird der dekodierte Wert als Zeichenfolge zurückgegeben.

Payloads der protobuf-Nachrichten entschlüsseln

Sie können SQL-Funktion dekodieren, um eine Regel zu konfigurieren, die die protobuf-Nachrichtennutzlast dekodieren kann. Weitere Informationen finden Sie unter Payloads von protobuf-Nachrichten dekodieren.

Die Signatur der Funktion sieht wie folgt aus:

decode(<ENCODED DATA>, 'proto', '<S3 BUCKET NAME>', '<S3 OBJECT KEY>', '<PROTO NAME>', '<MESSAGE TYPE>')            

Ein Beispiel für einen SQL-Ausdruck, der die SQL-Funktion decode verwendet, kann wie folgt aussehen:

SELECT VALUE decode(*, 'proto', 's3-bucket', 'messageformat.desc', 'myproto', 'messagetype') FROM 'some/topic'

encode(value, encodingScheme)

Verwenden Sie die Funktion encode, um die Nutzlast, bei der es sich möglicherweise um Nicht-JSON-Daten handelt, auf der Grundlage des Kodierungsschemas in ihre String-Darstellung zu kodieren. Unterstützt von der SQL Version vom 23.03.2016 und höher.

endswith(String, String)

Gibt einen Wert vom Typ Boolean zurück, der angibt, ob das erste String-Argument mit dem zweiten String-Argument endet. Wenn ein Argument Null oder Undefined ist, ist das Ergebnis Undefined. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: endswith("cat","at") = true.

exp(Decimal)

Gibt "e" zurück, potenziert mit dem Decimal-Argument. Decimal-Argumente werden vor dem Anwenden der Funktion auf doppelte Genauigkeit gerundet. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: exp(1) = e.

floor(Decimal)

Rundet den angegebenen Decimal-Wert auf den nächsten Int-Wert ab. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiele:

floor(1.2) = 1

floor(-1.2) = -2

get

Extrahiert einen Wert aus einem sammlungsartigen Typ (Array, Zeichenfolge, Objekt). Auf das erste Argument wird keine Konvertierung angewendet. Die Konvertierung wird wie in der Tabelle dokumentiert auf das zweite Argument angewendet. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiele:

get(["a", "b", "c"], 1) = "b"

get({"a":"b"}, "a") = "b"

get("abc", 0) = „a“.

get_dynamodb (tableName,,, partitionKeyName, partitionKeyValue roleArn) sortKeyName sortKeyValue

Ruft Daten aus einer DynamoDB-Tabelle ab. get_dynamodb() ermöglicht es Ihnen, eine DynamoDB-Tabelle abzufragen, während eine Regel evaluiert wird. Sie können den Nachrichten-Payload mit Hilfe von Daten aus DynamoDB filtern oder erweitern. Unterstützt von der SQL Version vom 23.03.2016 und höher.

get_dynamodb() verwendet folgenden Parameter:

Als Beispiel dafür, wie Sie get_dynamodb() verwenden können, nehmen wir an, Sie haben eine DynamoDB-Tabelle, die Geräte-ID- und Standortinformationen für alle mit AWS IoT verbundenen Geräte enthält. Die folgende SELECT-Anweisung verwendet die get_dynamodb()-Funktion, um den Standort für die angegebene Geräte-ID abzurufen:

SELECT *, get_dynamodb("InServiceDevices", "deviceId", id, "arn:aws:iam::12345678910:role/getdynamo").location AS location FROM 'some/topic'

get_mqtt_property(name)

Verweist auf einen der folgenden MQTT5-Header: contentType, payLoadFormatIndicator, responseTopic und correlationData Diese Funktion verwendet eine der folgenden Literalzeichenfolgen als Argument:content_type, format_indicator. response_topic und correlation_data Weitere Informationen in der folgenden Tabelle mit Funktionsargumenten.

Die folgende Tabelle zeigt die zulässigen Funktionsargumente und die zugehörigen Rückgabetypen für die get_mqtt_property-Funktion:

Das folgende Beispiel für Rules SQL verweist auf einen der folgenden MQTT5-Header:,, und. contentType payLoadFormatIndicator responseTopic correlationData

SELECT *, get_mqtt_property('content_type') as contentType,
          get_mqtt_property('format_indicator') as payloadFormatIndicator,
          get_mqtt_property('response_topic') as responseTopic,
          get_mqtt_property('correlation_data') as correlationData
FROM 'some/topic'

get_secret (secretId, geheimer Typ, Schlüssel, roleArn)

Ruft den Wert des verschlüsselten SecretString oder SecretBinary-Feldes der aktuellen Version eines Secrets in AWS Secrets Manager ab. Weitere Hinweise zum Erstellen und Verwalten von Geheimnissen finden Sie unter CreateSecretUpdateSecret, und PutSecretValue.

get_secret() verwendet folgenden Parameter:

Beispiele:

Sie können die get_secret-Funktion in einem Authentifizierungsheader in einer HTTPS-Regelaktion verwenden, wie im folgenden Beispiel für die API-Schlüsselauthentifizierung.

"API_KEY": "${get_secret('API_KEY', 'SecretString', 'API_KEY_VALUE', 'arn:aws:iam::12345678910:role/getsecret')}"
            

Weitere Informationen zu Regelaktionen finden Sie unter HTTP.

get_thing_shadow(thingName, shadowName, roleARN)

Gibt den angegebenen Schatten des angegebenen Geräts zurück. Unterstützt von der SQL Version vom 23.03.2016 und höher.

Beispiele:

Geben Sie bei Verwendung mit einem benannten Schatten den shadowName-Parameter an.

SELECT * from 'topic/subtopic'
WHERE
    get_thing_shadow("MyThing","MyThingShadow","arn:aws:iam::123456789012:role/AllowsThingShadowAccess")
    .state.reported.alarm = 'ON'

Lassen Sie bei Verwendung mit einem benannten Schatten den shadowName-Parameter aus.

SELECT * from 'topic/subtopic'
WHERE
    get_thing_shadow("MyThing","arn:aws:iam::123456789012:role/AllowsThingShadowAccess")
    .state.reported.alarm = 'ON'

get_user_properties () userPropertyKey

Verweist auf Benutzereigenschaften, eine Art von Eigenschaftsheadern, die in MQTT5 unterstützt werden.

Funktionsargumente

Für die folgenden Benutzereigenschaften in den Nachrichtenkopfzeilen:

Die folgende Tabelle zeigt das erwartete SQL-Verhalten:

Das folgende Beispiel für Rules SQL referenziert Benutzereigenschaften (eine Art MQTT5-Eigenschaftsheader) in die Nutzlast:

SELECT *, get_user_properties('user defined property key') as userProperty
FROM 'some/topic'

Hashfunktionen

AWS IoT bietet die folgenden Hashing-Funktionen:

Alle Hashfunktionen erwarten ein Zeichenfolgenargument. Das Ergebnis ist der Hashwert dieser Zeichenfolge. Standard-Zeichenfolgenkonvertierungen gelten für alle Argumente, die keine Zeichenfolgen sind. Alle Hashfunktionen werden von der SQL Version 2015-10-08 und höher unterstützt.

Beispiele:

md2("hello") = "a9046c73e00331af68917d3804f70655"

md5("hello") = "5d41402abc4b2a76b9719d911017c592"

indexof(String, String)

Gibt den ersten Index (0-basiert) des zweiten Arguments als Teilzeichenfolge des ersten Arguments zurück. Beide Argumente werden als Zeichenfolgen erwartet. Argumente, die keine Zeichenfolgen sind, unterliegen den Standardregeln für die Zeichenfolgenkonvertierung. Diese Funktion gilt nicht für Arrays, nur für Zeichenfolgen. Unterstützt von der SQL Version vom 23.03.2016 und höher.

Beispiele:

indexof("abcd", "bc") = 1

isNull()

Gibt „true“ zurück, wenn das Argument der Wert Null ist. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiele:

isNull(5) = false.

isNull(Null) = true.

isUndefined()

Gibt „true“ zurück, wenn das Argument Undefined ist. Unterstützt von der SQL Version vom 23.03.2016 und höher.

Beispiele:

isUndefined(5) = false.

isUndefined(floor([1,2,3]))) = true.

length(String)

Gibt die Anzahl der Zeichen in der angegebenen Zeichenfolge zurück. Für andere Argumente als String gelten Standardkonvertierungsregeln. Unterstützt von der SQL Version vom 23.03.2016 und höher.

Beispiele:

length("hi") = 2

length(false) = 5

ln(Decimal)

Gibt den natürlichen Logarithmus des Arguments zurück. Decimal-Argumente werden vor dem Anwenden der Funktion auf doppelte Genauigkeit gerundet. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: ln(e) = 1.

log(Decimal)

Gibt den Logarithmus des Arguments zur Basis 10 zurück. Decimal-Argumente werden vor dem Anwenden der Funktion auf doppelte Genauigkeit gerundet. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: log(100) = 2.0.

lower(String)

Gibt die kleingeschriebene Version des angegebenen String-Werts zurück. Andere Argumente als Zeichenfolgen werden mithilfe der Standardkonvertierungsregeln zu Zeichenfolgen konvertiert. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiele:

lower("HELLO") = „hello“

lower(["HELLO"]) = "[\"hello\"]"

lpad(String, Int)

Gibt das Argument String zurück, das auf der linken Seite mit der vom zweiten Argument festgelegten Anzahl an Leerzeichen aufgefüllt wurde. Das Argument Int muss zwischen 0 und 1000 liegen. Wenn der angegebene Wert außerhalb des gültigen Bereichs liegt, wird das Argument auf den nächsten gültigen Wert (0 oder 1000) festgelegt. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiele:

lpad("hello", 2) = "  hello".

lpad(1, 3) = "   1"

ltrim(String)

Entfernt alle führenden Leerzeichen (Tabulatoren und Leerzeichen) aus dem angegebenen String-Wert. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel:

Ltrim(" h i ") = "hi "

machinelearning_predict (modelId, roleArn, Datensatz)

Verwenden Sie die machinelearning_predict Funktion, um anhand der Daten aus einer MQTT-Nachricht, die auf einem SageMaker Amazon-Modell basiert, Vorhersagen zu treffen. Unterstützt von SQL Version 2015-10-08 und höher. Die Argumente für die machinelearning_predict-Funktion sind:

Die Funktion gibt ein JSON-Objekt mit den folgenden Feldern zurück:

mod(Decimal, Decimal)

Gibt den Rest zurück, der beim Teilen des ersten Arguments durch das zweite Argument entstanden ist. Äquivalent mit remainder(Decimal, Decimal). Sie können auch "%" als infix-Operator für die gleiche Modulfunktionalität verwenden. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: mod(8, 3) = 2

nanvl (AnyValue, AnyValue)

Gibt das erste Argument zurück, wenn es ein gültiger Decimal-Wert ist. Andernfalls wird das zweite Argument zurückgegeben. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: Nanvl(8, 3) = 8.

newuuid()

Gibt eine zufällige 16-Byte-UUID zurück. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: newuuid() = 123a4567-b89c-12d3-e456-789012345000

numbytes(String)

Gibt die Anzahl von Bytes in der UTF-8-Codierung der angegebenen Zeichenfolge zurück. Für andere Argumente als String gelten Standardkonvertierungsregeln. Unterstützt von der SQL Version vom 23.03.2016 und höher.

Beispiele:

numbytes("hi") = 2

numbytes("€") = 3

parse_time(String, Long, [String])

Verwenden Sie die Funktion parse_time, um einen Zeitstempel in ein verständliches Datums- und Zeitformat umzuwandeln. Unterstützt von der SQL Version vom 23.03.2016 und höher. Informationen zur Konvertierung einer Zeitstempelzeichenfolge in Millisekunden finden Sie unter time_to_epoch (Zeichenfolge, Zeichenfolge).

Die parse_time-Funktion verwendet folgende Argumente:

Beispiele:

Wenn diese Nachricht für das Thema „A/B“ veröffentlicht wird, wird die Nutzlast {"ts": "1970.01.01 AD at 21:46:40 CST"} an den S3-Bucket gesendet:

{
    "ruleArn": "arn:aws:iot:us-east-2:ACCOUNT_ID:rule/RULE_NAME",
    "topicRulePayload": {
        "sql": "SELECT parse_time(\"yyyy.MM.dd G 'at' HH:mm:ss z\", 100000000, 'America/Belize' ) as ts FROM 'A/B'",

        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "s3": {
                    "roleArn": "arn:aws:iam::ACCOUNT_ID:rule:role/ROLE_NAME",
                    "bucketName": "BUCKET_NAME",
                    "key": "KEY_NAME"
                }
            }
        ],
        "ruleName": "RULE_NAME"
    }
} 

Wenn diese Nachricht für das Thema „A/B“ veröffentlicht wird, wird eine Nutzlast ähnlich {"ts": "2017.06.09 AD at 17:19:46 UTC"} (aber mit aktuellen Datum/Uhrzeit) an den S3-Bucket gesendet:

{
    "ruleArn": "arn:aws:iot:us-east-2:ACCOUNT_ID:rule/RULE_NAME",
    "topicRulePayload": {
        "sql": "SELECT parse_time(\"yyyy.MM.dd G 'at' HH:mm:ss z\", timestamp() ) as ts FROM 'A/B'",
        "awsIotSqlVersion": "2016-03-23",
        "ruleDisabled": false,
        "actions": [
            {
                "s3": {
                    "roleArn": "arn:aws:iam::ACCOUNT_ID:rule:role/ROLE_NAME",
                    "bucketName": "BUCKET_NAME",
                    "key": "KEY_NAME"
                }
            }
        ],
        "ruleName": "RULE_NAME"
    }
} 

parse_time() kann auch als Ersatz-Vorlage verwendet werden. Wenn diese Nachricht beispielsweise für das Thema „A/B“ veröffentlicht wird, wird die Nutzlast an den S3-Bucket mit Schlüssel = „2017“ gesendet:

{
    "ruleArn": "arn:aws:iot:us-east-2:ACCOUNT_ID:rule/RULE_NAME",
    "topicRulePayload": {
        "sql": "SELECT * FROM 'A/B'",
        "awsIotSqlVersion": "2016-03-23",
        "ruleDisabled": false,
        "actions": [{
            "s3": {
                "roleArn": "arn:aws:iam::ACCOUNT_ID:rule:role/ROLE_NAME",
                "bucketName": "BUCKET_NAME",
                "key": "${parse_time('yyyy', timestamp(), 'UTC')}"
            }
        }],
        "ruleName": "RULE_NAME"
    }
}

power(Decimal, Decimal)

Gibt das erste Argument, potenziert mit dem zweiten Argument, zurück. Decimal-Argumente werden vor dem Anwenden der Funktion auf doppelte Genauigkeit gerundet. Unterstützt von SQL Version 2015-10-08 und höher. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: power(2, 5) = 32,0

Prinzipal()

Gibt den Prinzipal zurück, den das Gerät für die Authentifizierung verwendet, basierend darauf, wie die auslösende Nachricht veröffentlicht wurde. Die folgende Tabelle beschreibt den Prinzipal, der für jede Veröffentlichungsmethode und jedes Protokoll zurückgegeben wird.

Die folgenden Beispiele zeigen die verschiedenen Arten von Werten, die von principal() zurückgegeben werden:

rand()

Gibt einen pseudozufälligen, einheitlich verteilten doppelten Wert zwischen 0,0 und 1,0 zurück. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel:

rand() = 0.8231909191640703

regexp_matches(String, String)

Gibt „true“ zurück, wenn die Zeichenfolge (erstes Argument) eine Übereinstimmung für den regulären Ausdruck (zweites Argument) enthält. Wenn Sie | den regulären Ausdruck verwenden, verwenden Sie ihn mit ().

Beispiele:

regexp_matches("aaaa", "a{2,}") = true.

regexp_matches("aaaa", "b") = false.

regexp_matches("aaa", "(aaa|bbb)") = true.

regexp_matches("bbb", "(aaa|bbb)") = true.

regexp_matches("ccc", "(aaa|bbb)") = false.

Zweites Argument:

Muss ein gültiger regulärer Ausdruck sein. Nicht-String-Typen werden mit den Standardkonvertierungsregeln umgewandelt in String. Je nach Typ ist die resultierende Zeichenfolge unter Umständen kein gültiger regulärer Ausdruck. Wenn das (konvertierte) Argument kein gültiger regulärer Ausdruck ist, ist das Ergebnis Undefined.

regexp_replace(String, String, String)

Ersetzt alle Vorkommen des zweiten Arguments (regulärer Ausdruck) im ersten Argument durch das dritte Argument. Verweist auf Erfassungsgruppen mit "$". Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel:

regexp_replace("abcd", "bc", "x") = "axd"

regexp_replace("abcd", "b(.*)d", "$1") = "ac"

Zweites Argument:

Muss ein gültiger regulärer Ausdruck sein. Nicht-String-Typen werden mit den Standardkonvertierungsregeln umgewandelt in String. Je nach Typ ist die resultierende Zeichenfolge unter Umständen kein gültiger regulärer Ausdruck. Wenn das (konvertierte) Argument kein gültiger regulärer Ausdruck ist, ist das Ergebnis Undefined.

Drittes Argument:

Muss eine gültige RegEx-Ersetzungszeichenfolge sein. (Kann auf Erfassungsgruppen verweisen.) Nicht-String-Typen werden mit den Standardkonvertierungsregeln umgewandelt in String. Wenn das (konvertierte) Argument keine gültige RegEx-Ersetzungszeichenfolge ist, ist das Ergebnis Undefined.

regexp_substr(String, String)

Findet die erste Übereinstimmung des zweiten Parameters (regex) im ersten Parameter. Verweist auf Erfassungsgruppen mit "$". Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel:

regexp_substr("hihihello", "hi") = "hi"

regexp_substr("hihihello", "(hi)*") = "hihi"

Zweites Argument:

Muss ein gültiger regulärer Ausdruck sein. Nicht-String-Typen werden mit den Standardkonvertierungsregeln umgewandelt in String. Je nach Typ ist die resultierende Zeichenfolge unter Umständen kein gültiger regulärer Ausdruck. Wenn das (konvertierte) Argument kein gültiger regulärer Ausdruck ist, ist das Ergebnis Undefined.

remainder(Decimal, Decimal)

Gibt den Rest zurück, der beim Teilen des ersten Arguments durch das zweite Argument entstanden ist. Äquivalent mit mod(Decimal, Decimal). Sie können auch "%" als infix-Operator für die gleiche Modulfunktionalität verwenden. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: remainder(8, 3) = 2

replace(String, String, String)

Ersetzt alle Vorkommen des zweiten Arguments im ersten Argument durch das dritte Argument. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel:

replace("abcd", "bc", "x") = "axd".

replace("abcdabcd", "b", "x") = "axcdaxcd".

rpad(String, Int)

Gibt das Zeichenfolgenargument zurück, das auf der rechten Seite mit der im zweiten Argument festgelegten Anzahl an Leerzeichen aufgefüllt wurde. Das Argument Int muss zwischen 0 und 1000 liegen. Wenn der angegebene Wert außerhalb des gültigen Bereichs liegt, wird das Argument auf den nächsten gültigen Wert (0 oder 1000) festgelegt. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiele:

rpad("hello", 2) = "hello  ".

rpad(1, 3) = "1   ".

round(Decimal)

Runden den angegebenen Decimal-Wert auf den nächsten Int-Wert. Wenn Decimal gleich weit von zwei Int-Werten entfernt ist (z. B. 0,5), wird Decimal aufgerundet. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: Round(1.2) = 1.

Round(1.5) = 2.

Round(1.7) = 2.

Round(-1.1) = -1.

Round(-1.5) = -2.

rtrim(String)

Entfernt alle nachstehenden Leerzeichen (Tabulatoren und Leerzeichen) aus dem angegebenen String-Wert. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiele:

rtrim(" h i ") = " h i"

sign(Decimal)

Gibt das Vorzeichen der angegebenen Zahl zurück. Wenn das Vorzeichen des Arguments positiv ist, wird 1 zurückgegeben. Wenn das Vorzeichen des Arguments negativ ist, wird -1 zurückgegeben. Wenn das Argument 0 ist, wird 0 zurückgegeben. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiele:

sign(-7) = -1.

sign(0) = 0.

sign(13) = 1.

sin(Decimal)

Gibt den Sinus einer Zahl im Bogenmaß zurück. Decimal-Argumente werden vor dem Anwenden der Funktion auf doppelte Genauigkeit gerundet. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: sin(0) = 0,0

sinh(Decimal)

Gibt den hyperbolischen Sinus einer Zahl zurück. Decimal-Werte werden vor dem Anwenden der Funktion auf doppelte Genauigkeit gerundet. Das Ergebnis ist ein Decimal-Wert mit doppelter Genauigkeit. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: sinh(2.3) = 4,936961805545957

SourceIp

Ruft die IP-Adresse eines Geräts oder des Routers ab, der eine Verbindung zu diesem Gerät herstellt. Wenn Ihr Gerät direkt mit dem Internet verbunden ist, gibt die Funktion die Quell-IP-Adresse des Geräts zurück. Wenn Ihr Gerät mit einem Router verbunden ist, der eine Verbindung zum Internet herstellt, gibt die Funktion die Quell-IP-Adresse des Routers zurück. Unterstützt von der SQL-Version 2016-03-23. sourceip() benötigt keine Parameter.

Beispiele:

sourceip()="192.158.1.38"

sourceip()="1.102.103.104"

sourceip()="2001:db8:ff00::12ab:34cd"

SQL-Beispiel

SELECT *, sourceip() as deviceIp FROM 'some/topic'

Beispiele für die Verwendung der Funktion sourceip () in AWS IoT Core Regelaktionen:

Beispiel 1

Das folgende Beispiel zeigt, wie die Funktion () als Ersatzvorlage in einer DynamoDB-Maßnahme aufgerufen wird.

{
	"topicRulePayload": {
		"sql": "SELECT * AS message FROM 'some/topic'",
		"ruleDisabled": false,
		"awsIotSqlVersion": "2016-03-23",
		"actions": [
			{
				"dynamoDB": {
					"tableName": "my_ddb_table",
					"hashKeyField": "key",
					"hashKeyValue": "${sourceip()}",
					"rangeKeyField": "timestamp",
					"rangeKeyValue": "${timestamp()}",
					"roleArn": "arn:aws:iam::123456789012:role/aws_iot_dynamoDB"
				}
			}
		]
	}
}

Beispiel 2

Das folgende Beispiel zeigt, wie die Funktion sourceip() als MQTT-Benutzereigenschaft mithilfe von Ersetzungsvorlagen hinzugefügt wird.

{
	"topicRulePayload": {
		"sql": "SELECT * FROM 'some/topic'",
		"ruleDisabled": false,
		"awsIotSqlVersion": "2016-03-23",
		"actions": [
			{
				"republish": {
					"topic": "${topic()}/republish",
					"roleArn": "arn:aws:iam::123456789012:role/aws_iot_republish",
					"headers": {
						"payloadFormatIndicator": "UTF8_DATA",
						"contentType": "rule/contentType",
						"correlationData": "cnVsZSBjb3JyZWxhdGlvbiBkYXRh",
						"userProperties": [
							{
								"key": "ruleKey1",
								"value": "ruleValue1"
							},
							{
								"key": "sourceip",
								"value": "${sourceip()}"
							}
						]
					}
				}
			}
		]
	}
}            

Sie können die Quell-IP-Adresse aus Nachrichten abrufen, die sowohl über den Message Broker- als auch über den Basic-Ingest-Pfad an AWS IoT Core Regeln weitergeleitet werden. Sie können die Quell-IP auch für IPv4- und IPv6-Nachrichten abrufen. Die Quell-IP wird wie folgt angezeigt:

IPv6: yyyy:yyyy:yyyy::yyyy:yyyy

IPv4: xxx.xxx.xxx.xxx

substring(String, Int[, Int])

Erwartet einen String-Wert, gefolgt von einem oder zwei Int-Werten. Für einen String-Wert und ein einzelnes Int-Argument gibt diese Funktion die Teilzeichenfolge des angegebenen String-Werts vom angegebenen Int-Index (0-basiert, inklusive) am Ende des String-Werts zurück. Für einen String-Wert und ein zwei Int-Argumente gibt diese Funktion die Teilzeichenfolge des angegebenen String-Werts vom ersten Int-Indexargument (0-basiert, inklusive) an das zweiteInt-Indexargument (0-basiert, exklusive) zurück. Indizes, die kleiner als Null sind, werden auf Null festgelegt. Indizes, die größer sind als die String-Länge, werden auf die String-Länge festgelegt. Wenn bei drei Argumenten der erste Index mindestens genauso groß ist wie der zweite Index, ist das Ergebnis der leere String-Wert.

 Wenn die angegebenen Argumente nicht (Zeichenfolge, Int) oder (Zeichenfolge, Int, Int) lauten, werden die Standardkonvertierungen auf die Argumente angewendet, um sie in die korrekten Typen zu konvertieren. Wenn die Typen nicht konvertiert werden können, ist das Ergebnis der Funktion Undefined. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiele:

substring("012345", 0) = "012345".

substring("012345", 2) = "2345".

substring("012345", 2.745) = "2345".

substring(123, 2) = "3".

substring("012345", -1) = "012345".

substring(true, 1.2) = "true".

substring(false, -2.411E247) = "false".

substring("012345", 1, 3) = "12".

substring("012345", -50, 50) = "012345".

substring("012345", 3, 1) = "".

sql_version()

Gibt die in dieser Regel angegebene SQL Version zurück. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel:

sql_version() = "2016-03-23"

sqrt(Decimal)

Gibt die Quadratwurzel einer Zahl zurück. Decimal-Argumente werden vor dem Anwenden der Funktion auf doppelte Genauigkeit gerundet. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: sqrt(9) = 3.0.

startswith(String, String)

Gibt einen Wert vom Typ Boolean zurück, der angibt, ob das erste Zeichenfolgenargument mit dem zweiten Zeichenfolgenargument beginnt. Wenn ein Argument Null oder Undefined ist, ist das Ergebnis Undefined. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel:

startswith("ranger","ran") = true

tan(Decimal)

Gibt den Tangens einer Zahl im Bogenmaß zurück. Decimal-Werte werden vor dem Anwenden der Funktion auf doppelte Genauigkeit gerundet. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: tan(3) = -0,1425465430742778

tanh(Decimal)

Gibt den hyperbolischen Tangens einer Zahl im Bogenmaß zurück. Decimal-Werte werden vor dem Anwenden der Funktion auf doppelte Genauigkeit gerundet. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: tanh(2.3) = 0,9800963962661914

time_to_epoch (Zeichenfolge, Zeichenfolge)

Verwenden Sie die time_to_epoch-Funktion, um eine Zeitstempelzeichenfolge in eine Anzahl von Millisekunden in der Unix-Zeit umzuwandeln. Unterstützt von der SQL Version vom 23.03.2016 und höher. Informationen zur Konvertierung von Millisekunden in eine formatierte Zeitstempelzeichenfolge finden Sie unter parse_time(String, Long, [String]).

Die time_to_epoch-Funktion verwendet folgende Argumente:

Beispiele:

time_to_epoch("2020-04-03 09:45:18 UTC+01:00", "yyyy-MM-dd HH:mm:ss VV") = 1585903518000

time_to_epoch("18 December 2015", "dd MMMM yyyy") = 1450396800000

time_to_epoch("2007-12-03 10:15:30.592 America/Los_Angeles", "yyyy-MM-dd HH:mm:ss.SSS z") = 1196705730592

timestamp()

Gibt den aktuellen Zeitstempel in Millisekunden ab 00:00:00 Uhr Coordinated Universal Time (UTC), Donnerstag, 1. Januar 1970, zurück, wie er von der Regel-Engine beobachtet wird. AWS IoT Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel: timestamp() = 1481825251155

topic(Decimal)

Gibt das Topic zurück, an das die Nachricht gesendet wurde, welche die Regel ausgelöst hat. Wenn kein Parameter angegeben ist, wird das gesamte Topic zurückgegeben. Der Parameter Decimal wird verwendet, um ein bestimmtes Themensegment anzugeben, wobei 1 das erste Segment bezeichnet. Für das Thema foo/bar/baz gibt topic(1) foo zurück, topic(2) gibt bar zurück usw. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiele:

topic() = "things/myThings/thingOne"

topic(1) = "things"

Wenn Basic Ingest verwendet wird, ist das anfängliche Präfix des Themas ($aws/rules/rule-name) nicht für die Thema()-Funktion verfügbar. Angenommen, das Thema ist:

$aws/rules/BuildingManager/Buildings/Building5/Floor2/Room201/Lights

topic() = "Buildings/Building5/Floor2/Room201/Lights"(„Gebäude/Gebäude5/Etage2/Raum201/Beleuchtung“/)

topic(3) = "Floor2" („Etage2”)

traceid()

Gibt die Ablaufverfolgungs-ID (UUID) der MQTT-Nachricht zurück oder Undefined, wenn die Nachricht nicht über MQTT gesendet wurde. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel:

traceid() = "12345678-1234-1234-1234-123456789012"

transformieren (Zeichenfolge, Objekt, Array)

Gibt ein Array von Objekten zurück, das das Ergebnis der angegebenen Transformation des Object Parameters für den Array-Parameter enthält.

Unterstützt von der SQL Version vom 23.03.2016 und höher.

Beispiel 1 für die Transformationsfunktion

Dieses Beispiel zeigt, wie die transform()-Funktion aus einem Datenobjekt und einem Array ein einzelnes Array von Objekten erzeugt.

In diesem Beispiel wird folgende Nachricht im MQTT-Thema A/B veröffentlicht.

{
    "attributes": {
        "data1": 1,
        "data2": 2
    },
    "values": [
        {
            "a": 3
        },
        {
            "b": 4
        },
        {
            "c": 5
        }
    ]
}

Diese SQL-Anweisung für eine Themenregelaktion verwendet die transform()-Funktion mit dem Wert String von enrichArray. In diesem Beispiel Object handelt es sich um die attributes-Eigenschaft aus der Nachrichtennutzlast und um Array das values Array, das drei Objekte enthält.

select value transform("enrichArray", attributes, values) from 'A/B'

Nach dem Empfang der Nachrichtennutzdaten wird die SQL-Anweisung zu der folgenden Antwort ausgewertet.

[
  {
    "a": 3,
    "data1": 1,
    "data2": 2
  },
  {
    "b": 4,
    "data1": 1,
    "data2": 2
  },
  {
    "c": 5,
    "data1": 1,
    "data2": 2
  }
]

Beispiel 2 für die Transformationsfunktion

Dieses Beispiel zeigt, wie die transform()-Funktion Literalwerte verwenden kann, um einzelne Attribute aus der Nachrichtennutzlast einzubeziehen und umzubenennen.

In diesem Beispiel wird folgende Nachricht im MQTT-Thema A/B veröffentlicht. Dies ist dieselbe Nachricht, die in Beispiel 1 für die Transformationsfunktion verwendet wurde.

{
    "attributes": {
        "data1": 1,
        "data2": 2
    },
    "values": [
        {
            "a": 3
        },
        {
            "b": 4
        },
        {
            "c": 5
        }
    ]
}

Diese SQL-Anweisung für eine Themenregelaktion verwendet die transform()-Funktion mit dem Wert String von enrichArray. Die Object in der transform()-Funktion hat ein einzelnes Attribut, das key mit dem Wert von attributes.data1 in der Nachrichtennutzlast benannt ist, und Array ist das values Array, das dieselben drei Objekte enthält, die im vorherigen Beispiel verwendet wurden.

select value transform("enrichArray", {"key": attributes.data1}, values) from 'A/B'

Nach dem Empfang der Nachrichtennutzdaten wird diese SQL-Anweisung zu der folgenden Antwort ausgewertet. Beachten Sie, wie die data1-Eigenschaft key in der Antwort benannt ist.

[
  {
    "a": 3,
    "key": 1
  },
  {
    "b": 4,
    "key": 1
  },
  {
    "c": 5,
    "key": 1
  }
]

Beispiel 3 für die Transformationsfunktion

Dieses Beispiel zeigt, wie die transform()-Funktion in verschachtelten SELECT-Klauseln verwendet werden kann, um mehrere Attribute auszuwählen und neue Objekte für die nachfolgende Verarbeitung zu erstellen.

In diesem Beispiel wird folgende Nachricht im MQTT-Thema A/B veröffentlicht.

{
  "data1": "example",
  "data2": {
    "a": "first attribute",
    "b": "second attribute",
    "c": [
      {
        "x": {
          "someInt": 5,
          "someString": "hello"
        },
        "y": true
      },
      {
        "x": {
          "someInt": 10,
          "someString": "world"
        },
        "y": false
      }
    ]
  }
}

Das Object für diese Transformationsfunktion ist das Objekt, das von der SELECT-Anweisung zurückgegeben wurde, die die Elemente a und b des data2-Objekts der Nachricht enthält. Der Array-Parameter besteht aus den beiden Objekten aus dem data2.c Array in der ursprünglichen Nachricht.

select value transform('enrichArray', (select a, b from data2), (select value c from data2)) from 'A/B'

Bei der vorherigen Nachricht ergibt die SQL-Anweisung die folgende Antwort.

[
  {
    "x": {
      "someInt": 5,
      "someString": "hello"
    },
    "y": true,
    "a": "first attribute",
    "b": "second attribute"
  },
  {
    "x": {
      "someInt": 10,
      "someString": "world"
    },
    "y": false,
    "a": "first attribute",
    "b": "second attribute"
  }
]

Das in dieser Antwort zurückgegebene Array könnte mit Themenregelaktionen verwendet werden, die batchMode unterstützen.

trim(String)

Entfernt alle führenden und nachfolgenden Leerzeichen aus dem angegebenen String-Wert. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiel:

Trim(" hi ") = "hi"

trunc(Decimal, Int)

Schneidet das erste Argument auf die Anzahl von Decimal-Stellen ab, die vom zweiten Argument festgelegt wurden. Wenn das zweite Argument kleiner ist als Null, wird es auf Null festgelegt. Wenn das zweite Argument größer ist als 34, wird es auf 34 festgelegt. Nachfolgende Nullen werden aus dem Ergebnis entfernt. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiele:

trunc(2.3, 0) = 2.

trunc(2.3123, 2) = 2,31.

trunc(2.888, 2) = 2,88.

trunc(2.00, 5) = 2.

upper(String)

Gibt die großgeschriebene Version des angegebenen String-Werts zurück. Andere Argumente als String werden mit der Standardkonvertierungsregeln in ,String konvertiert. Unterstützt von SQL Version 2015-10-08 und höher.

Beispiele:

upper("hello") = "HELLO"

upper(["hello"]) = "[\"HELLO\"]"