Für ähnliche Funktionen wie Amazon Timestream für sollten Sie Amazon Timestream for LiveAnalytics InfluxDB in Betracht ziehen. Es bietet eine vereinfachte Datenaufnahme und Antwortzeiten im einstelligen Millisekundenbereich für Analysen in Echtzeit. [Erfahren](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html) Sie hier mehr.

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
<a name="API_query_CreateScheduledQuery"></a>

 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
<a name="API_query_CreateScheduledQuery_RequestSyntax"></a>

```
{
   "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
<a name="API_query_CreateScheduledQuery_RequestParameters"></a>

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ClientToken"></a>
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 wird`ClientToken`, generiert das Query SDK 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](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ErrorReportConfiguration"></a>
Konfiguration für die Fehler-Berichterstellung. Fehlerberichte werden generiert, wenn beim Schreiben der Abfrage-Ergebnisse ein Problem auftritt.   
Typ: [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) Objekt  
Erforderlich: Ja

 ** [KmsKeyId](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-KmsKeyId"></a>
Der Amazon-KMS-Schlüssel, der zur Verschlüsselung der geplanten Abfrage-Ressource verwendet wird, at-rest. Wenn der Amazon-KMS-Schlüssel nicht angegeben ist, wird die geplante Abfrage-Ressource mit einem Timestream-eigenen Amazon-KMS-Schlüssel verschlüsselt. Um einen KMS-Schlüssel anzugeben, verwenden Sie seine Schlüssel-ID, seinen Schlüssel-ARN, seinen Aliasnamen oder seinen Alias-ARN. 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](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Name"></a>
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](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-NotificationConfiguration"></a>
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](API_query_NotificationConfiguration.md) Objekt  
Erforderlich: Ja

 ** [QueryString](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-QueryString"></a>
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](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduleConfiguration"></a>
Die Zeitplankonfiguration für die Abfrage.  
Typ: [ScheduleConfiguration](API_query_ScheduleConfiguration.md) Objekt  
Erforderlich: Ja

 ** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduledQueryExecutionRoleArn"></a>
Der ARN für die IAM-Rolle, die Timestream beim Ausführen 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](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Tags"></a>
Eine Liste von Schlüssel-Wert-Paaren zur Benennung der geplanten Abfrage.  
Typ: Array von [Tag](API_query_Tag.md)-Objekten  
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.  
Erforderlich: Nein

 ** [TargetConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-TargetConfiguration"></a>
Konfiguration, die zum Schreiben des Ergebnisses einer Abfrage verwendet wird.  
Typ: [TargetConfiguration](API_query_TargetConfiguration.md) Objekt  
Erforderlich: Nein

## Antwortsyntax
<a name="API_query_CreateScheduledQuery_ResponseSyntax"></a>

```
{
   "Arn": "string"
}
```

## Antwortelemente
<a name="API_query_CreateScheduledQuery_ResponseElements"></a>

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

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

 ** [Arn](#API_query_CreateScheduledQuery_ResponseSyntax) **   <a name="timestream-query_CreateScheduledQuery-response-Arn"></a>
ARN fü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
<a name="API_query_CreateScheduledQuery_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** AccessDeniedException **   
Sie verfügen nicht über die erforderlichen Berechtigungen, um auf die Kontoeinstellungen zuzugreifen.  
HTTP-Statuscode: 400

 ** ConflictException **   
 Die Ergebnisse für eine stornierte Abfrage konnten nicht abgefragt werden.   
HTTP-Statuscode: 400

 ** InternalServerException **   
Bei der Verarbeitung der Anfrage ist ein interner Serverfehler aufgetreten.  
HTTP-Statuscode: 400

 ** InvalidEndpointException **   
Der angeforderte Endpunkt ist ungültig.  
HTTP-Statuscode: 400

 ** ServiceQuotaExceededException **   
Sie haben das Dienstkontingent überschritten.  
HTTP-Statuscode: 400

 ** ThrottlingException **   
Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt.  
HTTP-Statuscode: 400

 ** ValidationException **   
 Ungültige oder falsch formatierte Anfrage.   
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_query_CreateScheduledQuery_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CreateScheduledQuery)