CreateScheduledQuery - Amazon Timestream
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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.

CreateScheduledQuery

Erstellen Sie eine geplante Abfrage, die in Ihrem Namen nach dem konfigurierten Zeitplan ausgeführt wird. Timestream übernimmt die Ausführungsrolle, die als Teil des ScheduledQueryExecutionRoleArn-Parameters bereitgestellt wird, um die Abfrage auszuführen. Sie können den NotificationConfiguration-Parameter verwenden, um die Benachrichtigung für Ihre geplanten Abfragevorgänge zu konfigurieren.

Anforderungssyntax

{
   "ClientToken": "string",
   "ErrorReportConfiguration": { 
      "S3Configuration": { 
         "BucketName": "string",
         "EncryptionOption": "string",
         "ObjectKeyPrefix": "string"
      }
   },
   "KmsKeyId": "string",
   "Name": "string",
   "NotificationConfiguration": { 
      "SnsConfiguration": { 
         "TopicArn": "string"
      }
   },
   "QueryString": "string",
   "ScheduleConfiguration": { 
      "ScheduleExpression": "string"
   },
   "ScheduledQueryExecutionRoleArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TargetConfiguration": { 
      "TimestreamConfiguration": { 
         "DatabaseName": "string",
         "DimensionMappings": [ 
            { 
               "DimensionValueType": "string",
               "Name": "string"
            }
         ],
         "MeasureNameColumn": "string",
         "MixedMeasureMappings": [ 
            { 
               "MeasureName": "string",
               "MeasureValueType": "string",
               "MultiMeasureAttributeMappings": [ 
                  { 
                     "MeasureValueType": "string",
                     "SourceColumn": "string",
                     "TargetMultiMeasureAttributeName": "string"
                  }
               ],
               "SourceColumn": "string",
               "TargetMeasureName": "string"
            }
         ],
         "MultiMeasureMappings": { 
            "MultiMeasureAttributeMappings": [ 
               { 
                  "MeasureValueType": "string",
                  "SourceColumn": "string",
                  "TargetMultiMeasureAttributeName": "string"
               }
            ],
            "TargetMultiMeasureName": "string"
         },
         "TableName": "string",
         "TimeColumn": "string"
      }
   }
}

Anforderungsparameter

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.

Die Anfrage akzeptiert die folgenden Daten im JSON Format.

ClientToken

Die Verwendung von a ClientToken macht den Aufruf CreateScheduledQuery idempotent, mit anderen Worten, wenn dieselbe Anfrage wiederholt gestellt wird, führt dies zu demselben Ergebnis. Das Stellen mehrerer identischer CreateScheduledQuery Anfragen hat den gleichen Effekt wie das Stellen einer einzelnen Anfrage.

  • Wenn ohne a aufgerufen CreateScheduledQuery wirdClientToken, SDK generiert die Query in ClientToken Ihrem Namen eine.

  • Nach 8 Stunden wird jede Anforderung mit dem gleichen ClientToken als neue Anforderung behandelt.

Typ: Zeichenfolge

Längenbeschränkungen: Mindestlänge von 32. Maximale Länge beträgt 128 Zeichen.

Erforderlich: Nein

ErrorReportConfiguration

Konfiguration für die Fehler-Berichterstellung. Fehlerberichte werden generiert, wenn beim Schreiben der Abfrage-Ergebnisse ein Problem auftritt.

Typ: ErrorReportConfiguration Objekt

Erforderlich: Ja

KmsKeyId

Der KMS Amazon-Schlüssel, der verwendet wird, um die geplante Abfrageressource im Ruhezustand zu verschlüsseln. Wenn der KMS Amazon-Schlüssel nicht angegeben ist, wird die geplante Abfrageressource mit einem Timestream-eigenen KMS Amazon-Schlüssel verschlüsselt. Um einen KMS Schlüssel anzugeben, verwenden Sie die Schlüssel-ID, den SchlüsselARN, den Aliasnamen oder den AliasARN. Wenn Sie einen Aliasnamen verwenden, stellen Sie dem Namen alias/ voran.

Wenn SSE_KMS als Verschlüsselungstyp ErrorReportConfiguration verwendet wird, KmsKeyId wird derselbe verwendet, um den Fehlerbericht im Ruhezustand zu verschlüsseln.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.

Erforderlich: Nein

Name

Name der geplanten Abfrage.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.

Pattern: [a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+

Erforderlich: Ja

NotificationConfiguration

Benachrichtigungs-Konfiguration für eine geplante Abfrage. Timestream sendet eine Benachrichtigung, wenn ein Abfragelauf abgeschlossen ist, wenn der Status aktualisiert wird oder wenn Sie ihn löschen.

Typ: NotificationConfiguration Objekt

Erforderlich: Ja

QueryString

Die auszuführende Abfragezeichenfolge. Parameternamen können in der Abfragezeichenfolge @ Zeichen gefolgt von einer Kennung angegeben werden. Der benannte Parameter @scheduled_runtime ist reserviert und kann in der Abfrage verwendet werden, um den Zeitpunkt abzurufen, zu dem die Abfrage planmäßig ausgeführt werden soll.

Der anhand des ScheduleConfiguration Parameters berechnete Zeitstempel entspricht dem Wert von @scheduled_runtime paramater für jeden Abfragelauf. Stellen Sie sich zum Beispiel eine Instance einer geplanten Abfrage vor, die am 01.12.2021 00:00:00 ausgeführt wird. In dieser Instance wird der @scheduled_runtime Parameter beim Aufrufen der Abfrage mit dem Zeitstempel 2021-12-01 00:00:00 initialisiert.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 262144.

Erforderlich: Ja

ScheduleConfiguration

Die Zeitplankonfiguration für die Abfrage.

Typ: ScheduleConfiguration Objekt

Erforderlich: Ja

ScheduledQueryExecutionRoleArn

Die ARN für die IAM Rolle, die Timestream bei der Ausführung der geplanten Abfrage übernimmt.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.

Erforderlich: Ja

Tags

Eine Liste von Schlüssel-Wert-Paaren zur Benennung der geplanten Abfrage.

Typ: Array von Tag-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.

Erforderlich: Nein

TargetConfiguration

Konfiguration, die zum Schreiben des Ergebnisses einer Abfrage verwendet wird.

Typ: TargetConfiguration Objekt

Erforderlich: Nein

Antwortsyntax

{
   "Arn": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Dienst eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Dienst im JSON Format zurückgegeben.

Arn

ARNfür die erstellte geplante Abfrage.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

AccessDeniedException

Sie verfügen nicht über die erforderlichen Berechtigungen, um auf die Kontoeinstellungen zuzugreifen.

HTTPStatuscode: 400

ConflictException

Die Ergebnisse für eine stornierte Abfrage konnten nicht abgefragt werden.

HTTPStatuscode: 400

InternalServerException

Bei der Bearbeitung der Anfrage ist ein interner Serverfehler aufgetreten.

HTTPStatuscode: 400

InvalidEndpointException

Der angeforderte Endpunkt ist ungültig.

HTTPStatuscode: 400

ServiceQuotaExceededException

Sie haben das Servicekontingent überschritten.

HTTPStatuscode: 400

ThrottlingException

Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.

HTTPStatuscode: 400

ValidationException

Ungültige oder falsch formatierte Anfrage.

HTTPStatuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: