Skip to content

Commit 0c36b74

Browse files
softarksamdark
authored andcommitted
docs/guide-ja updated [skip ci] (#351)
1 parent 8828b0b commit 0c36b74

File tree

4 files changed

+93
-2
lines changed

4 files changed

+93
-2
lines changed

docs/guide-ja/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@ Yii2 キュー・エクステンション
2222
* [Beanstalk](driver-beanstalk.md)
2323
* [Gearman](driver-gearman.md)
2424
* [AWS SQS](driver-sqs.md)
25+
* [Stomp](driver-stomp.md)
2526

2627
開発ツール
2728
----------

docs/guide-ja/driver-db.md

Lines changed: 29 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,9 @@ return [
3333
];
3434
```
3535

36-
データベースにテーブルを追加する必要があります。MySQL のためのスキーマ例:
36+
データベースにテーブルを追加する必要があります。スキーマ例:
37+
38+
MySQL:
3739

3840
```SQL
3941
CREATE TABLE `queue` (
@@ -53,8 +55,33 @@ CREATE TABLE `queue` (
5355
KEY `priority` (`priority`)
5456
) ENGINE=InnoDB
5557
```
58+
Postgresql:
59+
60+
```SQL
61+
-- オートインクリメント・フィールドを作成するために必要
62+
CREATE SEQUENCE queue_seq;
63+
64+
CREATE TABLE queue (
65+
id bigint NOT NULL DEFAULT NEXTVAL ('queue_seq'),
66+
channel varchar(255) NOT NULL,
67+
job bytea NOT NULL,
68+
pushed_at bigint NOT NULL,
69+
ttr bigint NOT NULL,
70+
delay bigint NOT NULL DEFAULT 0,
71+
priority bigint check (priority > 0) NOT NULL DEFAULT 1024,
72+
reserved_at bigint ,
73+
attempt bigint,
74+
done_at bigint,
75+
PRIMARY KEY (id)
76+
);
77+
-- 必須ではないが、クエリを高速化するのに良い
78+
CREATE INDEX channel ON queue (channel);
79+
CREATE INDEX reserved_at ON queue (reserved_at);
80+
CREATE INDEX priority ON queue (priority);
81+
```
82+
5683

57-
マイグレーションが [src/drivers/db/migrations](../../src/drivers/db/migrations) から取得できます
84+
マイグレーションが [src/drivers/db/migrations](../../src/drivers/db/migrations) にありますので、利用して下さい
5885

5986
アプリケーションにマイグレーションを追加するためには、コンソールの構成ファイルを編集して、
6087
[名前空間化されたマイグレーション](http://www.yiiframework.com/doc-2.0/guide-db-migrations.html#namespaced-migrations) を構成して下さい。

docs/guide-ja/driver-sqs.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,30 @@ return [
2424
];
2525
```
2626

27+
FIFO キューのための構成例:
28+
29+
```php
30+
return [
31+
'bootstrap' => [
32+
'queue', // コンポーネントが自身のコンソール・コマンドを登録します
33+
],
34+
'components' => [
35+
'queue' => [
36+
'class' => \yii\queue\sqs\Queue::class,
37+
'url' => '<sqs url>',
38+
'key' => '<key>',
39+
'secret' => '<secret>',
40+
'region' => '<region>',
41+
'messageGroupId' => '<Group ID>',
42+
],
43+
],
44+
];
45+
```
46+
47+
SQS では、FIFO キューのためにはメッセージ・グループ ID が必要です。自分自身で構成するか、"default" という値を使って下さい。
48+
49+
重複回避 ID が自動的に生成されます。そのため、SQS キューでコンテント・ベースの重複回避を有効にしていたとしても、この ID が使われることになります。
50+
2751
コンソール
2852
----------
2953

docs/guide-ja/driver-stomp.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
Stomp ドライバ
2+
==============
3+
4+
5+
このドライバは ActiveMQ キューで動作します。
6+
7+
`enqueue/stomp` パッケージを必要とします。
8+
9+
構成例:
10+
11+
```php
12+
return [
13+
'bootstrap' => [
14+
'queue', // コンポーネントが自身のコンソール・コマンドを登録します
15+
],
16+
'components' => [
17+
'queue' => [
18+
'class' => \yii\queue\stomp\Queue::class,
19+
'host' => 'localhost',
20+
'port' => 61613,
21+
'queueName' => 'queue',
22+
],
23+
],
24+
];
25+
```
26+
27+
コンソール
28+
----------
29+
30+
キューに入れられたジョブを実行するためにコンソール・コマンドが使用されます。
31+
32+
```sh
33+
yii queue/listen [timeout]
34+
```
35+
36+
`listen` コマンドは無限にキューを調べ続けるデーモンを起動します。キューに新しいタスクがあると、即座に取得され、実行されます。
37+
`timeout` パラメータはキューを調べる間のスリープの秒数を指定するものです。
38+
このコマンドを [supervisor](worker.md#supervisor) または [systemd](worker.md#systemd) によって適切にデーモン化するのが、
39+
最も効率的な方法です。

0 commit comments

Comments
 (0)